ImageEdit

Ce ImageEdit composant offre des capacités d’envoi d’images pour les colonnes d’images Dataverse. Il peut afficher un aperçu de l’image actuelle et prend en charge la sélection de fichiers par glisser-déposer.

React
Blazor

Affichage de l’image

Configuré DisplayImage="true" pour afficher un aperçu de l’image téléchargée. Lorsqu’il est désactivé, seuls le nom du fichier et le contrôle d’envoi sont affichés.

React
Blazor

Taille maximale de fichier

Utilisez MaxFileSize pour définir la taille maximale autorisée du fichier en octets.

React
Blazor

Exemple

Une liaison basique ImageEdit à une colonne d’image.

Exemple de réaction
Exemple de Blazor

Déposez une image ici, ou cliquez pour parcourir

React TypeScript
Razor

Configuration Options

Utilisez les commandes ci-dessous pour explorer les propriétés disponibles.

Exemple de réaction
Exemple de Blazor
Lecture seule ? Obligatoire ? Handicapé ? Image d’affichage ?

Déposez une image ici, ou cliquez pour parcourir

React TypeScript
Razor

Prétraitement du téléchargement de fichiers

Si vous devez pré-traiter les fichiers avant qu’ils ne soient sauvegardés sur Dataverse, utilisez le OnFileUploaded callback pour vous connecter au processus de téléversement et appliquer une gestion personnalisée au fichier.

FileSaveOptions Classe

Propriétés

Nom
Type
Par défaut
Description
OnFileUploadedFunc<ColumnFileInfo, Task<FileInfo>>?
Un rappel optionnel invoqué après qu’un fichier soit téléchargé et avant qu’il ne soit sauvegardé sur Dataverse. Reçoit un Models.ColumnFileInfo contenant les données du fichier et la table/colonne cible, et renvoie A Models.FileInfo avec le fichier (potentiellement modifié) pour sauvegarder. Utilisez-le pour redimensionner des images, convertir des formats de fichiers, scanner les virus ou appliquer d’autres transformations.
SaveModeFileSaveMode
SaveToTemporaryFolder
Le mode utilisé pour stocker temporairement le fichier lors de l’upload. FileSaveMode.SaveToTemporaryFolder écrit le fichier dans un dossier temporaire sur le serveur avant de sauvegarder sur Dataverse. FileSaveMode.Stream transmet le fichier directement à Dataverse sans stockage intermédiaire. Par défaut, .FileSaveMode.SaveToTemporaryFolder
Nom: OnFileUploaded
Type: Func<ColumnFileInfo, Task<FileInfo>>?
Description: Un rappel optionnel invoqué après qu’un fichier soit téléchargé et avant qu’il ne soit sauvegardé sur Dataverse. Reçoit un Models.ColumnFileInfo contenant les données du fichier et la table/colonne cible, et renvoie A Models.FileInfo avec le fichier (potentiellement modifié) pour sauvegarder. Utilisez-le pour redimensionner des images, convertir des formats de fichiers, scanner les virus ou appliquer d’autres transformations.
Nom: SaveMode
Type: FileSaveMode
Par défaut: SaveToTemporaryFolder
Description: Le mode utilisé pour stocker temporairement le fichier lors de l’upload. FileSaveMode.SaveToTemporaryFolder écrit le fichier dans un dossier temporaire sur le serveur avant de sauvegarder sur Dataverse. FileSaveMode.Stream transmet le fichier directement à Dataverse sans stockage intermédiaire. Par défaut, .FileSaveMode.SaveToTemporaryFolder

ColumnFileInfo Classe

Propriétés

Nom
Type
Par défaut
Description
ColumnNamestring
Le nom logique du fichier ou de la colonne image où le fichier est téléchargé.
FileInfoFileInfo
Les informations de fichier téléversées incluent le nom du fichier, la taille et le contenu binaire.
TableNamestring
Le nom logique de la table Dataverse où le fichier est téléchargé.
Nom: ColumnName
Type: string
Description: Le nom logique du fichier ou de la colonne image où le fichier est téléchargé.
Nom: FileInfo
Type: FileInfo
Description: Les informations de fichier téléversées incluent le nom du fichier, la taille et le contenu binaire.
Nom: TableName
Type: string
Description: Le nom logique de la table Dataverse où le fichier est téléchargé.

FileInfo Classe

Propriétés

Nom
Type
Par défaut
Description
FileDatabyte[]?
Le contenu binaire brut du fichier. Peut être nulle si le fichier n’a pas encore été lu en mémoire.
FileNamestring
Le nom original du fichier incluant l’extension (par exemple « document.pdf »).
FileSizeInByteslong
0
La taille du fichier en octets.
Nom: FileData
Type: byte[]?
Description: Le contenu binaire brut du fichier. Peut être nulle si le fichier n’a pas encore été lu en mémoire.
Nom: FileName
Type: string
Description: Le nom original du fichier incluant l’extension (par exemple « document.pdf »).
Nom: FileSizeInBytes
Type: long
Par défaut: 0
Description: La taille du fichier en octets.
Réagir Blazor

ImageEdit Classe

Paramètres

Nom
Type
Par défaut
Description
ChildContentRenderFragment?
Contenu enfant du composant
ColumnName*string
Nom logique de colonne pour lier l’éditeur à partir de l’enregistrement de table.
Descriptionstring?
Description à afficher dans l’infobulle.
Disabledbool?
Si l’éditeur est désactivé.
DisplayImagebool
False
Lorsque c’est vrai, le binaire image est téléchargé depuis Dataverse et rendu en ligne.
DisplayLabelWhenAvailablebool
True
Précise s’il faut afficher une étiquette si disponible.
DisplayTooltipWhenAvailablebool
True
Précise s’il faut afficher une infobulle si disponible.
DisplayValidationErrorMessagebool
True
Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?
IsVisiblebool
True
L’éditeur est-il visible ?
Labelstring?
Le texte doit être affiché comme une étiquette pour l’éditeur.
MaxFileSizeInByteslong?
Obtient ou définit la taille maximale d’un fichier à téléverser (en octets). La valeur par défaut est de 10 Mo, soit la valeur spécifiée par les métadonnées de la colonne.
OutputFormatImageOutputFormat
Auto
Format de sortie utilisé lors du commit des modifications dans la colonne liée. Par défaut — ImageOutputFormat.Auto les entrées JPEG restent JPEG, tout le reste émet du PNG. Épingler à ImageOutputFormat.Png pour les écritures sans perte, quoi qu’il en soit de la source, ou ImageOutputFormat.Jpeg pour la taille— Des colonnes photo sensibles. Transmis à l’embarqué ImageViewer.OutputFormat.
OutputQualitydouble
0,9
Qualité JPEG en [0, 1]. Ignoré quand ImageEdit.OutputFormat se résout vers PNG. Par défaut, c’est 0,9. Transmis à ImageViewer.OutputQuality.
ReadOnlybool?
L’éditeur devrait-il être en lecture seule ?
Requiredbool?
Si la valeur est requise.
ValueFileValue?
Valeur de la colonne.
Nom: ChildContent
Type: RenderFragment?
Description: Contenu enfant du composant
Nom: ColumnName*
Type: string
Description: Nom logique de colonne pour lier l’éditeur à partir de l’enregistrement de table.
Nom: Description
Type: string?
Description: Description à afficher dans l’infobulle.
Nom: Disabled
Type: bool?
Description: Si l’éditeur est désactivé.
Nom: DisplayImage
Type: bool
Par défaut: False
Description: Lorsque c’est vrai, le binaire image est téléchargé depuis Dataverse et rendu en ligne.
Nom: DisplayLabelWhenAvailable
Type: bool
Par défaut: True
Description: Précise s’il faut afficher une étiquette si disponible.
Nom: DisplayTooltipWhenAvailable
Type: bool
Par défaut: True
Description: Précise s’il faut afficher une infobulle si disponible.
Nom: DisplayValidationErrorMessage
Type: bool
Par défaut: True
Description: Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?
Nom: IsVisible
Type: bool
Par défaut: True
Description: L’éditeur est-il visible ?
Nom: Label
Type: string?
Description: Le texte doit être affiché comme une étiquette pour l’éditeur.
Nom: MaxFileSizeInBytes
Type: long?
Description: Obtient ou définit la taille maximale d’un fichier à téléverser (en octets). La valeur par défaut est de 10 Mo, soit la valeur spécifiée par les métadonnées de la colonne.
Nom: OutputFormat
Type: ImageOutputFormat
Par défaut: Auto
Description: Format de sortie utilisé lors du commit des modifications dans la colonne liée. Par défaut — ImageOutputFormat.Auto les entrées JPEG restent JPEG, tout le reste émet du PNG. Épingler à ImageOutputFormat.Png pour les écritures sans perte, quoi qu’il en soit de la source, ou ImageOutputFormat.Jpeg pour la taille— Des colonnes photo sensibles. Transmis à l’embarqué ImageViewer.OutputFormat.
Nom: OutputQuality
Type: double
Par défaut: 0,9
Description: Qualité JPEG en [0, 1]. Ignoré quand ImageEdit.OutputFormat se résout vers PNG. Par défaut, c’est 0,9. Transmis à ImageViewer.OutputQuality.
Nom: ReadOnly
Type: bool?
Description: L’éditeur devrait-il être en lecture seule ?
Nom: Required
Type: bool?
Description: Si la valeur est requise.
Nom: Value
Type: FileValue?
Description: Valeur de la colonne.

Événements

Nom
Type
Description
ValueChangedEventCallback<ColumnValueBase>
Obtient ou définit un callback qui met à jour la valeur liée.
Nom: ValueChanged
Type: EventCallback<ColumnValueBase>
Description: Obtient ou définit un callback qui met à jour la valeur liée.

Méthodes

Nom
Paramètres
Type
Description
GetValidationErrorsList<string>
Retourne une collection des erreurs de validation courantes.
Nom: GetValidationErrors
Type: List<string>
Description: Retourne une collection des erreurs de validation courantes.