ImageEdit

O ImageEdit componente oferece capacidades de upload de imagens para colunas de imagens do Dataverse. Ele pode exibir uma prévia da imagem atual e suporta a seleção de arquivos por arrastar e soltar.

React

Blazor

Exibindo a Imagem

Configure DisplayImage="true" para mostrar uma prévia da imagem enviada. Quando desativado, apenas o nome do arquivo e o controle de upload são exibidos.

React

Blazor

Tamanho Máximo do Arquivo

Use MaxFileSize para definir o tamanho máximo permitido do arquivo em bytes.

React

Blazor

Exemplo

Um limite básico ImageEdit a uma coluna de imagem.

Exemplo de reação

Exemplo de Blazor

Imagem Primária

Deixe uma imagem aqui ou clique para navegar

React TypeScript

Razor

Opções de configuração

Use os controles abaixo para explorar as propriedades disponíveis.

Exemplo de reação

Exemplo de Blazor

Somente leitura?

Obrigatório?

Deficiente?

Imagem de exibição?

Tamanho máximo do arquivo (bytes)

Imagem Primária

Deixe uma imagem aqui ou clique para navegar

React TypeScript

Razor

Pré-processamento de Upload de Arquivos

Se você precisar pré-processar arquivos antes de serem salvos no Dataverse, use o OnFileUploaded callback para acessar o processo de upload e aplicar um tratamento personalizado ao arquivo.

FileSaveOptions Classe

Propriedades

Nome	Tipo	Padrão	Descrição
`OnFileUploaded`	Func<ColumnFileInfo, Task<FileInfo>>?		Um callback opcional é invocado após o upload de um arquivo e antes de ser salvo no Dataverse. Recebe um `Models.ColumnFileInfo` contendo os dados do arquivo e a tabela/coluna de destino, e retorna A `Models.FileInfo` com o arquivo (potencialmente modificado) para salvar. Use isso para redimensionar imagens, converter formatos de arquivo, escanear vírus ou aplicar outras transformações.
`SaveMode`	FileSaveMode	SaveToTemporaryFolder	O modo usado para armazenar temporariamente o arquivo durante o upload. `FileSaveMode.SaveToTemporaryFolder` grava o arquivo em uma pasta temporária no servidor antes de salvar no Dataverse. `FileSaveMode.Stream` transmite o arquivo diretamente para o Dataverse sem armazenamento intermediário. O padrão é .`FileSaveMode.SaveToTemporaryFolder`

Nome: OnFileUploaded

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

Descrição: Um callback opcional é invocado após o upload de um arquivo e antes de ser salvo no Dataverse. Recebe um Models.ColumnFileInfo contendo os dados do arquivo e a tabela/coluna de destino, e retorna A Models.FileInfo com o arquivo (potencialmente modificado) para salvar. Use isso para redimensionar imagens, converter formatos de arquivo, escanear vírus ou aplicar outras transformações.

Nome: SaveMode

Tipo: FileSaveMode

Padrão: SaveToTemporaryFolder

Descrição: O modo usado para armazenar temporariamente o arquivo durante o upload. FileSaveMode.SaveToTemporaryFolder grava o arquivo em uma pasta temporária no servidor antes de salvar no Dataverse. FileSaveMode.Stream transmite o arquivo diretamente para o Dataverse sem armazenamento intermediário. O padrão é .FileSaveMode.SaveToTemporaryFolder

ColumnFileInfo Classe

Propriedades

Nome	Tipo	Descrição
`ColumnName`	string	O nome lógico da coluna do arquivo ou imagem para onde o arquivo está sendo enviado.
`FileInfo`	FileInfo	As informações do arquivo enviadas, incluindo nome, tamanho e conteúdo binário.
`TableName`	string	O nome lógico da tabela Dataverse para onde o arquivo está sendo enviado.

Nome: ColumnName

Tipo: string

Descrição: O nome lógico da coluna do arquivo ou imagem para onde o arquivo está sendo enviado.

Nome: FileInfo

Tipo: FileInfo

Descrição: As informações do arquivo enviadas, incluindo nome, tamanho e conteúdo binário.

Nome: TableName

Tipo: string

Descrição: O nome lógico da tabela Dataverse para onde o arquivo está sendo enviado.

FileInfo Classe

Propriedades

Nome	Tipo	Padrão	Descrição
`FileData`	byte[]?		O conteúdo binário bruto do arquivo. Pode ser nulo se o arquivo ainda não foi lido na memória.
`FileName`	string		O nome original do arquivo inclui a extensão (por exemplo, 'document.pdf').
`FileSizeInBytes`	long	0	O tamanho do arquivo em bytes.

Nome: FileData

Tipo: byte[]?

Descrição: O conteúdo binário bruto do arquivo. Pode ser nulo se o arquivo ainda não foi lido na memória.

Nome: FileName

Tipo: string

Descrição: O nome original do arquivo inclui a extensão (por exemplo, 'document.pdf').

Nome: FileSizeInBytes

Tipo: long

Padrão: 0

Descrição: O tamanho do arquivo em bytes.

React

Blazor

ImageEdit Classe

Parâmetros

Nome	Tipo	Padrão	Descrição
`ChildContent`	RenderFragment?		Conteúdo filho do componente
`ColumnName`*	string		Nome lógico da coluna para vincular o editor a partir do registro da tabela.
`Description`	string?		Descrição será exibida na dica de ferramenta.
`Disabled`	bool?		Caso o editor esteja desativado.
`DisplayImage`	bool	False	Quando verdadeiro, o binário da imagem é baixado do Dataverse e renderizado em linha.
`DisplayLabelWhenAvailable`	bool	True	Especifica se deve exibir uma lable, se disponível.
`DisplayTooltipWhenAvailable`	bool	True	Especifica se deve exibir uma dica de ferramenta, se disponível.
`DisplayValidationErrorMessage`	bool	True	Uma mensagem de erro de validação deve ser exibida quando o componente falha na validação?
`IsVisible`	bool	True	O editor é visível?
`Label`	string?		Texto para ser exibido como um rótulo para o editor.
`MaxFileSizeInBytes`	long?		Recebe ou define o tamanho máximo de um arquivo a ser enviado (em bytes). O valor padrão é 10 MB ou o valor especificado pelos metadados da coluna.
`OutputFormat`	ImageOutputFormat	Auto	Formato de saída usado ao fazer commit de edições de volta para a coluna vinculada. Padrão para `ImageOutputFormat.Auto` — entradas JPEG permanecem JPEG, todo o resto emite PNG. Pin to `ImageOutputFormat.Png` para escritas sem perdas, independentemente disso de origem, ou `ImageOutputFormat.Jpeg` para o tamanho— Colunas de fotos sensíveis. Encaminhado para o embedded `ImageViewer.OutputFormat`.
`OutputQuality`	double	0,9	Qualidade JPEG em [0, 1]. Ignorado quando `ImageEdit.OutputFormat` resolve para PNG. O padrão é 0,9. Encaminhado para `ImageViewer.OutputQuality`.
`ReadOnly`	bool?		O editor deve ser somente leitura.
`Required`	bool?		Se o valor for necessário.
`Value`	FileValue?		Valor da coluna.

Nome: ChildContent

Tipo: RenderFragment?

Descrição: Conteúdo filho do componente

Nome: ColumnName*

Tipo: string

Descrição: Nome lógico da coluna para vincular o editor a partir do registro da tabela.

Nome: Description

Tipo: string?

Descrição: Descrição será exibida na dica de ferramenta.

Nome: Disabled

Tipo: bool?

Descrição: Caso o editor esteja desativado.

Nome: DisplayImage

Tipo: bool

Padrão: False

Descrição: Quando verdadeiro, o binário da imagem é baixado do Dataverse e renderizado em linha.

Nome: DisplayLabelWhenAvailable

Tipo: bool

Padrão: True

Descrição: Especifica se deve exibir uma lable, se disponível.

Nome: DisplayTooltipWhenAvailable

Tipo: bool

Padrão: True

Descrição: Especifica se deve exibir uma dica de ferramenta, se disponível.

Nome: DisplayValidationErrorMessage

Tipo: bool

Padrão: True

Descrição: Uma mensagem de erro de validação deve ser exibida quando o componente falha na validação?

Nome: IsVisible

Tipo: bool

Padrão: True

Descrição: O editor é visível?

Nome: Label

Tipo: string?

Descrição: Texto para ser exibido como um rótulo para o editor.

Nome: MaxFileSizeInBytes

Tipo: long?

Descrição: Recebe ou define o tamanho máximo de um arquivo a ser enviado (em bytes). O valor padrão é 10 MB ou o valor especificado pelos metadados da coluna.

Nome: OutputFormat

Tipo: ImageOutputFormat

Padrão: Auto

Descrição: Formato de saída usado ao fazer commit de edições de volta para a coluna vinculada. Padrão para ImageOutputFormat.Auto — entradas JPEG permanecem JPEG, todo o resto emite PNG. Pin to ImageOutputFormat.Png para escritas sem perdas, independentemente disso de origem, ou ImageOutputFormat.Jpeg para o tamanho— Colunas de fotos sensíveis. Encaminhado para o embedded ImageViewer.OutputFormat.

Nome: OutputQuality

Tipo: double

Padrão: 0,9

Descrição: Qualidade JPEG em [0, 1]. Ignorado quando ImageEdit.OutputFormat resolve para PNG. O padrão é 0,9. Encaminhado para ImageViewer.OutputQuality.

Nome: ReadOnly

Tipo: bool?

Descrição: O editor deve ser somente leitura.

Nome: Required

Tipo: bool?

Descrição: Se o valor for necessário.

Nome: Value

Tipo: FileValue?

Descrição: Valor da coluna.

Eventos

Nome	Tipo	Descrição
`ValueChanged`	EventCallback<ColumnValueBase>	Recebe ou define um callback que atualiza o valor vinculado.

Nome: ValueChanged

Tipo: EventCallback<ColumnValueBase>

Descrição: Recebe ou define um callback que atualiza o valor vinculado.

Métodos

Nome	Parâmetros	Tipo	Descrição
`GetValidationErrors`		List<string>	Retorna uma coleção dos erros de validação atuais.

Nome: GetValidationErrors

Tipo: List<string>

Descrição: Retorna uma coleção dos erros de validação atuais.