ElecciónEdición

El ChoiceEdit componente muestra una columna de elección de Dataverse (conjunto de opciones/lista de selecciones) como un desplegable o grupo de botones de radio para la selección de valor único.

React

Blazor

Tipo de editor

Configura EditorType para elegir entre ChoiceEditType.Dropdown (por defecto) o ChoiceEditType.RadioButtons. Al usar botones de opción, úsalo RadioButtonOrientation para controlar la disposición vertical u horizontal. Los botones de radio horizontales se envuelven en la siguiente fila cuando se quedan sin espacio; configurados WrapRadioButtons para false desplazarlos en su lugar.

React

Blazor

Orden de clasificación

Configura SortOrder para controlar cómo se ordenan las opciones. Las opciones incluyen Default (orden Dataverse), DisplayName, DisplayNameDescending, Value, y ValueDescending.

React

Blazor

Ejemplo

Un acotamiento básico ChoiceEdit a una columna de elección.

Ejemplo de reacción

Ejemplo de Blazor

React TypeScript

Razor

Color favorito

(Seleccione un valor)

Rojo

Azul

Naranja

Morado

Amarillo

Negro

Blanco

Brown

Verde

Opciones de configuración

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

Ejemplo de reacción

Ejemplo de Blazor

React TypeScript

Razor

¿Solo lectura?

¿Obligatorio?

¿Deshabilitado?

¿Colores de la pantalla?

Orden de clasificación

Default

Nombre de Muestra

Nombre de Visualización Descendente

Valor

Valor descendente

Comportamiento de valor inválido

Desactivar

Eliminar

Elección nula

Predeterminado (Auto)

Programa

Escóndete

Tipo

Despregable

Botones de radio

Color favorito

(Seleccione un valor)

Rojo

Azul

Naranja

Morado

Amarillo

Negro

Blanco

Brown

Verde

Reaccionar

Blazor

ChoiceEdit 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?
`DisplayChoiceColors`	bool	False	Cuando es cierto, se muestra una pequeña muestra del color que se da a cada opción en Dataverse a su lado, y junto al valor seleccionado de un desplegable cerrado. Opciones sin color obtienen Un espacio vacío, para que las etiquetas sigan alineadas. Por defecto es falso.
`DisplayLabelWhenAvailable`	bool	True	Especifica si mostrar una lable si está disponible.
`DisplayNullChoice`	bool?		Si mostrar una opción '(ninguno)' que limpia la columna de nuevo a nula. Cuando se omite, el valor por defecto es requerido-consciente: una columna requerida lo oculta (el usuario debe elegir un valor real); Una columna no necesaria lo demuestra. Set explícitamente para anular cualquiera de los valores por defecto.
`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?
`EditorType`	ChoiceEditType	Dropdown	Tipo de editor para renderizar
`InvalidChoiceValues`	IEnumerable<int>?		Opcionalmente, especifica qué valores son inválidos.
`InvalidValueBehavior`	ChoiceInvalidValueBehavior	Remove	Determina el comportamiento de valores inválidos. Solo aplicable cuando se suministra el `BaseChoiceEditCommon.ValidChoiceValues` parámetro o `BaseChoiceEditCommon.InvalidChoiceValues` .
`IsVisible`	bool	True	¿El editor es visible?
`Label`	string?		El texto se mostrará como etiqueta para el editor.
`RadioButtonOrientation`	ComponentOrientation	Vertical	Orientación de los botones de radio. Solo válido cuando el `BaseChoiceEdit.EditorType` está establecido en `ChoiceEditType.RadioButtons`.
`ReadOnly`	bool?		¿Debería el editor ser solo lectura?
`Required`	bool?		Si el valor es necesario.
`Sort`	ChoiceValueSort	Default	Determina cómo se ordenan los valores.
`ValidChoiceValues`	IEnumerable<int>?		Opcionalmente, especifica qué valores son válidos.
`Value`	int?		Valor de la columna.
`WrapRadioButtons`	bool	True	Cuando es cierto (por defecto), los botones de radio horizontales que se quedan sin espacio se envuelven en el siguiente fila; cuando son falsas, permanecen en una fila, que se desplaza. No afecta a las verticales.

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

Tipo: bool

Default: False

Descripción: Cuando es cierto, se muestra una pequeña muestra del color que se da a cada opción en Dataverse a su lado, y junto al valor seleccionado de un desplegable cerrado. Opciones sin color obtienen Un espacio vacío, para que las etiquetas sigan alineadas. Por defecto es falso.

Nombre: DisplayLabelWhenAvailable

Tipo: bool

Default: True

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

Nombre: DisplayNullChoice

Tipo: bool?

Descripción: Si mostrar una opción '(ninguno)' que limpia la columna de nuevo a nula. Cuando se omite, el valor por defecto es requerido-consciente: una columna requerida lo oculta (el usuario debe elegir un valor real); Una columna no necesaria lo demuestra. Set explícitamente para anular cualquiera de los valores por defecto.

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

Tipo: ChoiceEditType

Default: Dropdown

Descripción: Tipo de editor para renderizar

Nombre: InvalidChoiceValues

Tipo: IEnumerable<int>?

Descripción: Opcionalmente, especifica qué valores son inválidos.

Nombre: InvalidValueBehavior

Tipo: ChoiceInvalidValueBehavior

Default: Remove

Descripción: Determina el comportamiento de valores inválidos. Solo aplicable cuando se suministra el BaseChoiceEditCommon.ValidChoiceValues parámetro o BaseChoiceEditCommon.InvalidChoiceValues .

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

Tipo: ComponentOrientation

Default: Vertical

Descripción: Orientación de los botones de radio. Solo válido cuando el BaseChoiceEdit.EditorType está establecido en ChoiceEditType.RadioButtons.

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

Tipo: ChoiceValueSort

Default: Default

Descripción: Determina cómo se ordenan los valores.

Nombre: ValidChoiceValues

Tipo: IEnumerable<int>?

Descripción: Opcionalmente, especifica qué valores son válidos.

Nombre: Value

Tipo: int?

Descripción: Valor de la columna.

Nombre: WrapRadioButtons

Tipo: bool

Default: True

Descripción: Cuando es cierto (por defecto), los botones de radio horizontales que se quedan sin espacio se envuelven en el siguiente fila; cuando son falsas, permanecen en una fila, que se desplaza. No afecta a las verticales.

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.