ChoiceEdit

Le ChoiceEdit composant affiche une colonne de choix Dataverse (option set/picklist) sous forme de menu déroulant ou de groupe de boutons radio pour la sélection à valeur unique.

React

Blazor

Type de montage

Régler EditorType pour choisir entre ChoiceEditType.Dropdown (par défaut) ou ChoiceEditType.RadioButtons. Lorsque vous utilisez des boutons radio, utilisez RadioButtonOrientation pour contrôler la disposition verticale ou horizontale. Les boutons radio horizontaux s’enroulent sur la rangée suivante lorsqu’ils manquent d’espace ; réglés WrapRadioButtons pour false les faire défiler à la place.

React

Blazor

Ordre de tri

Réglez SortOrder pour contrôler l’ordre des options. Les options incluent Default (ordre Dataverse), DisplayName, DisplayNameDescending, Value, et ValueDescending.

React

Blazor

Exemple

Un lien basique ChoiceEdit vers une colonne de choix.

Exemple de réaction

Exemple de Blazor

React TypeScript

Razor

Couleur préférée

(Sélectionnez une valeur)

Rouge

Bleu

Orange

Violet

Jaune

Noir

Blanc

Brown

Vert

Configuration Options

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

Exemple de réaction

Exemple de Blazor

React TypeScript

Razor

Lecture seule ?

Obligatoire ?

Handicapé ?

Couleurs d’affichage choisies ?

Ordre de tri

Par défaut

Nom d’affichage

Nom d’affichage décroissant

Valeur

Valeur décroissante

Comportement de valeur invalide

Désactiver

Retirer

Choix nul

Par défaut (Auto)

Émission

Cache-toi

Type

Déroulant

Boutons radio

Couleur préférée

(Sélectionnez une valeur)

Rouge

Bleu

Orange

Violet

Jaune

Noir

Blanc

Brown

Vert

Réagir

Blazor

ChoiceEdit Classe

Paramètres

Nom	Type	Par défaut	Description
`ChildContent`	RenderFragment?		Contenu enfant du composant
`ColumnName`*	string		Nom logique de colonne pour lier l’éditeur à partir de l’enregistrement de table.
`Description`	string?		Description à afficher dans l’infobulle.
`Disabled`	bool?		Si l’éditeur est désactivé.
`DisplayChoiceColors`	bool	False	Lorsqu’il est vrai, un petit échantillon de la couleur donnée à chaque option dans Dataverse est affiché à côté, et à côté de la valeur sélectionnée d’un menu déroulant fermé. Options sans couleur un espace vide, donc les libelles s’alignent toujours. Par défaut, c’est faux.
`DisplayLabelWhenAvailable`	bool	True	Précise s’il faut afficher une étiquette si disponible.
`DisplayNullChoice`	bool?		S’il faut afficher un choix « (aucun) » qui efface la colonne en nulle. Lorsqu’il est omis, le défaut est requis : une colonne requise le masque (l’utilisateur doit choisir une valeur réelle) ; une colonne non obligatoire le montre. Décor explicitement pour annuler l’un ou l’autre par défaut.
`DisplayTooltipWhenAvailable`	bool	True	Précise s’il faut afficher une infobulle si disponible.
`DisplayValidationErrorMessage`	bool	True	Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?
`EditorType`	ChoiceEditType	Dropdown	Type d’éditeur à rendre
`InvalidChoiceValues`	IEnumerable<int>?		Éventuellement, spécifiez quelles valeurs sont invalides.
`InvalidValueBehavior`	ChoiceInvalidValueBehavior	Remove	Détermine le comportement des valeurs invalides. Applicable uniquement lorsque le `BaseChoiceEditCommon.ValidChoiceValues` paramètre ou `BaseChoiceEditCommon.InvalidChoiceValues` est fourni.
`IsVisible`	bool	True	L’éditeur est-il visible ?
`Label`	string?		Le texte doit être affiché comme une étiquette pour l’éditeur.
`RadioButtonOrientation`	ComponentOrientation	Vertical	Orientation des boutons radio. Valable seulement lorsque le `BaseChoiceEdit.EditorType` est défini à `ChoiceEditType.RadioButtons`.
`ReadOnly`	bool?		L’éditeur devrait-il être en lecture seule ?
`Required`	bool?		Si la valeur est requise.
`Sort`	ChoiceValueSort	Default	Détermine comment les valeurs sont triées.
`ValidChoiceValues`	IEnumerable<int>?		Éventuellement, spécifiez quelles valeurs sont valides.
`Value`	int?		Valeur de la colonne.
`WrapRadioButtons`	bool	True	Lorsque c’est vrai (par défaut), les boutons radio horizontaux qui manquent d’espace s’enroulent sur le rangée suivante ; lorsqu’ils sont faux, ils restent sur une seule ligne, qui défile. Ça n’a aucun effet sur les rangées verticales.

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: DisplayChoiceColors

Type: bool

Par défaut: False

Description: Lorsqu’il est vrai, un petit échantillon de la couleur donnée à chaque option dans Dataverse est affiché à côté, et à côté de la valeur sélectionnée d’un menu déroulant fermé. Options sans couleur un espace vide, donc les libelles s’alignent toujours. Par défaut, c’est faux.

Nom: DisplayLabelWhenAvailable

Type: bool

Par défaut: True

Description: Précise s’il faut afficher une étiquette si disponible.

Nom: DisplayNullChoice

Type: bool?

Description: S’il faut afficher un choix « (aucun) » qui efface la colonne en nulle. Lorsqu’il est omis, le défaut est requis : une colonne requise le masque (l’utilisateur doit choisir une valeur réelle) ; une colonne non obligatoire le montre. Décor explicitement pour annuler l’un ou l’autre par défaut.

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: EditorType

Type: ChoiceEditType

Par défaut: Dropdown

Description: Type d’éditeur à rendre

Nom: InvalidChoiceValues

Type: IEnumerable<int>?

Description: Éventuellement, spécifiez quelles valeurs sont invalides.

Nom: InvalidValueBehavior

Type: ChoiceInvalidValueBehavior

Par défaut: Remove

Description: Détermine le comportement des valeurs invalides. Applicable uniquement lorsque le BaseChoiceEditCommon.ValidChoiceValues paramètre ou BaseChoiceEditCommon.InvalidChoiceValues est fourni.

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: RadioButtonOrientation

Type: ComponentOrientation

Par défaut: Vertical

Description: Orientation des boutons radio. Valable seulement lorsque le BaseChoiceEdit.EditorType est défini à ChoiceEditType.RadioButtons.

Nom: ReadOnly

Type: bool?

Description: L’éditeur devrait-il être en lecture seule ?

Nom: Required

Type: bool?

Description: Si la valeur est requise.

Nom: Sort

Type: ChoiceValueSort

Par défaut: Default

Description: Détermine comment les valeurs sont triées.

Nom: ValidChoiceValues

Type: IEnumerable<int>?

Description: Éventuellement, spécifiez quelles valeurs sont valides.

Nom: Value

Type: int?

Description: Valeur de la colonne.

Nom: WrapRadioButtons

Type: bool

Par défaut: True

Description: Lorsque c’est vrai (par défaut), les boutons radio horizontaux qui manquent d’espace s’enroulent sur le rangée suivante ; lorsqu’ils sont faux, ils restent sur une seule ligne, qui défile. Ça n’a aucun effet sur les rangées verticales.

Événements

Nom	Type	Description
`ValueChanged`	EventCallback<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
`GetValidationErrors`		List<string>	Retourne une collection des erreurs de validation courantes.

Nom: GetValidationErrors

Type: List<string>

Description: Retourne une collection des erreurs de validation courantes.