ImageEdit

El ImageEdit componente proporciona capacidades de carga de imágenes para las columnas de imágenes de Dataverse. Puede mostrar una vista previa de la imagen actual y permite la selección de archivos mediante arrastrar y soltar.

React

Blazor

Mostrar la imagen

Configurado DisplayImage="true" para mostrar una vista previa de la imagen subida. Cuando se desactiva, solo se muestra el nombre del archivo y el control de subida.

React

Blazor

Tamaño máximo de archivo

Úsalo MaxFileSize para establecer el tamaño máximo permitido de archivo en bytes.

React

Blazor

Ejemplo

Un acotado básico ImageEdit a una columna de imagen.

Ejemplo de reacción

Ejemplo de Blazor

Imagen primaria

Deja una imagen aquí o haz clic para navegar

React TypeScript

Razor

Opciones de configuración

Utiliza los controles a continuación para explorar las propiedades disponibles.

Ejemplo de reacción

Ejemplo de Blazor

¿Solo lectura?

¿Obligatorio?

¿Deshabilitado?

¿Imagen de pantalla?

Tamaño máximo de archivo (bytes)

Imagen primaria

Deja una imagen aquí o haz clic para navegar

React TypeScript

Razor

Preprocesamiento de carga de archivos

Si necesitas preprocesar archivos antes de guardarlos en Dataverse, usa la OnFileUploaded callback para conectarte al proceso de subida y aplicar un manejo personalizado al archivo.

FileSaveOptions Clase

Propiedades

Nombre	Tipo	Default	Descripción
`OnFileUploaded`	Func<ColumnFileInfo, Task<FileInfo>>?		Una devolución de llamada opcional que se invoca tras la subida de un archivo y antes de que se guarde en Dataverse. Recibe una `Models.ColumnFileInfo` que contiene los datos del archivo y la tabla/columna de destino, y devuelve a `Models.FileInfo` con el archivo (potencialmente modificado) para guardar. Úsalo para redimensionar imágenes, convertir formatos de archivo, escanear virus o aplicar otras transformaciones.
`SaveMode`	FileSaveMode	SaveToTemporaryFolder	El modo utilizado para almacenar temporalmente el archivo durante la subida. `FileSaveMode.SaveToTemporaryFolder` escribe el archivo en una carpeta temporal del servidor antes de guardar en Dataverse. `FileSaveMode.Stream` transmite el archivo directamente a Dataverse sin almacenamiento intermedio. Por defecto es `FileSaveMode.SaveToTemporaryFolder`.

Nombre: OnFileUploaded

Tipo: Func<ColumnFileInfo, Task<FileInfo>>?

Descripción: Una devolución de llamada opcional que se invoca tras la subida de un archivo y antes de que se guarde en Dataverse. Recibe una Models.ColumnFileInfo que contiene los datos del archivo y la tabla/columna de destino, y devuelve a Models.FileInfo con el archivo (potencialmente modificado) para guardar. Úsalo para redimensionar imágenes, convertir formatos de archivo, escanear virus o aplicar otras transformaciones.

Nombre: SaveMode

Tipo: FileSaveMode

Default: SaveToTemporaryFolder

Descripción: El modo utilizado para almacenar temporalmente el archivo durante la subida. FileSaveMode.SaveToTemporaryFolder escribe el archivo en una carpeta temporal del servidor antes de guardar en Dataverse. FileSaveMode.Stream transmite el archivo directamente a Dataverse sin almacenamiento intermedio. Por defecto es FileSaveMode.SaveToTemporaryFolder.

ColumnFileInfo Clase

Propiedades

Nombre	Tipo	Descripción
`ColumnName`	string	El nombre lógico de la columna de archivo o imagen a la que se está subiendo el archivo.
`FileInfo`	FileInfo	La información del archivo subida, incluyendo nombre, tamaño y contenido binario.
`TableName`	string	El nombre lógico de la tabla Dataverse a la que se está subiendo el archivo.

Nombre: ColumnName

Tipo: string

Descripción: El nombre lógico de la columna de archivo o imagen a la que se está subiendo el archivo.

Nombre: FileInfo

Tipo: FileInfo

Descripción: La información del archivo subida, incluyendo nombre, tamaño y contenido binario.

Nombre: TableName

Tipo: string

Descripción: El nombre lógico de la tabla Dataverse a la que se está subiendo el archivo.

FileInfo Clase

Propiedades

Nombre	Tipo	Default	Descripción
`FileData`	byte[]?		El contenido binario bruto del archivo. Puede ser nulo si el archivo aún no ha sido leído en memoria.
`FileName`	string		El nombre original del archivo incluye la extensión (por ejemplo, 'document.pdf').
`FileSizeInBytes`	long	0	El tamaño del archivo en bytes.

Nombre: FileData

Tipo: byte[]?

Descripción: El contenido binario bruto del archivo. Puede ser nulo si el archivo aún no ha sido leído en memoria.

Nombre: FileName

Tipo: string

Descripción: El nombre original del archivo incluye la extensión (por ejemplo, 'document.pdf').

Nombre: FileSizeInBytes

Tipo: long

Default: 0

Descripción: El tamaño del archivo en bytes.

Reaccionar

Blazor

ImageEdit Clase

Parámetros

Nombre	Tipo	Default	Descripción
`ChildContent`	RenderFragment?		Contenido hijo del componente
`ColumnName`*	string		Nombre lógico de columna para vincular el editor desde el registro de la tabla.
`Description`	string?		La descripción se mostrará en la descripción emergente.
`Disabled`	bool?		¿Debería desactivar el editor?
`DisplayImage`	bool	False	Cuando es cierto, el binario de imagen se descarga desde Dataverse y se renderiza en línea.
`DisplayLabelWhenAvailable`	bool	True	Especifica si mostrar una lable si está disponible.
`DisplayTooltipWhenAvailable`	bool	True	Especifica si mostrar una descripción emergente si está disponible.
`DisplayValidationErrorMessage`	bool	True	¿Debe mostrarse un mensaje de error de validación cuando el componente falla en la validación?
`IsVisible`	bool	True	¿El editor es visible?
`Label`	string?		El texto se mostrará como etiqueta para el editor.
`MaxFileSizeInBytes`	long?		Obtiene o establece el tamaño máximo de un archivo a subir (en bytes). El valor predeterminado es 10 MB o el valor especificado por los metadatos de la columna.
`OutputFormat`	ImageOutputFormat	Auto	Formato de salida utilizado al confirmar las ediciones de vuelta a la columna encotada. Por defecto — `ImageOutputFormat.Auto` las entradas JPEG se mantienen JPEG, todo lo demás emite PNG. Pin to `ImageOutputFormat.Png` Independientemente de escrituras sin pérdidas de origen, o `ImageOutputFormat.Jpeg` por tamaño- columnas fotográficas sensibles. Reenviado al sistema embebido `ImageViewer.OutputFormat`.
`OutputQuality`	double	0,9	Calidad JPEG en [0, 1]. Ignorado cuando `ImageEdit.OutputFormat` se resuelve a PNG. Por defecto es 0,9. Reenviado a `ImageViewer.OutputQuality`.
`ReadOnly`	bool?		¿Debería el editor ser solo lectura?
`Required`	bool?		Si el valor es necesario.
`Value`	FileValue?		Valor de la columna.

Nombre: ChildContent

Tipo: RenderFragment?

Descripción: Contenido hijo del componente

Nombre: ColumnName*

Tipo: string

Descripción: Nombre lógico de columna para vincular el editor desde el registro de la tabla.

Nombre: Description

Tipo: string?

Descripción: La descripción se mostrará en la descripción emergente.

Nombre: Disabled

Tipo: bool?

Descripción: ¿Debería desactivar el editor?

Nombre: DisplayImage

Tipo: bool

Default: False

Descripción: Cuando es cierto, el binario de imagen se descarga desde Dataverse y se renderiza en línea.

Nombre: DisplayLabelWhenAvailable

Tipo: bool

Default: True

Descripción: Especifica si mostrar una lable si está disponible.

Nombre: DisplayTooltipWhenAvailable

Tipo: bool

Default: True

Descripción: Especifica si mostrar una descripción emergente si está disponible.

Nombre: DisplayValidationErrorMessage

Tipo: bool

Default: True

Descripción: ¿Debe mostrarse un mensaje de error de validación cuando el componente falla en la validación?

Nombre: IsVisible

Tipo: bool

Default: True

Descripción: ¿El editor es visible?

Nombre: Label

Tipo: string?

Descripción: El texto se mostrará como etiqueta para el editor.

Nombre: MaxFileSizeInBytes

Tipo: long?

Descripción: Obtiene o establece el tamaño máximo de un archivo a subir (en bytes). El valor predeterminado es 10 MB o el valor especificado por los metadatos de la columna.

Nombre: OutputFormat

Tipo: ImageOutputFormat

Default: Auto

Descripción: Formato de salida utilizado al confirmar las ediciones de vuelta a la columna encotada. Por defecto — ImageOutputFormat.Auto las entradas JPEG se mantienen JPEG, todo lo demás emite PNG. Pin to ImageOutputFormat.Png Independientemente de escrituras sin pérdidas de origen, o ImageOutputFormat.Jpeg por tamaño- columnas fotográficas sensibles. Reenviado al sistema embebido ImageViewer.OutputFormat.

Nombre: OutputQuality

Tipo: double

Default: 0,9

Descripción: Calidad JPEG en [0, 1]. Ignorado cuando ImageEdit.OutputFormat se resuelve a PNG. Por defecto es 0,9. Reenviado a ImageViewer.OutputQuality.

Nombre: ReadOnly

Tipo: bool?

Descripción: ¿Debería el editor ser solo lectura?

Nombre: Required

Tipo: bool?

Descripción: Si el valor es necesario.

Nombre: Value

Tipo: FileValue?

Descripción: Valor de la columna.

Eventos

Nombre	Tipo	Descripción
`ValueChanged`	EventCallback<ColumnValueBase>	Recibe o establece una callback que actualiza el valor vinculado.

Nombre: ValueChanged

Tipo: EventCallback<ColumnValueBase>

Descripción: Recibe o establece una callback que actualiza el valor vinculado.

Métodos

Nombre	Parámetros	Tipo	Descripción
`GetValidationErrors`		List<string>	Devuelve una colección de los errores de validación actuales.

Nombre: GetValidationErrors

Tipo: List<string>

Descripción: Devuelve una colección de los errores de validación actuales.