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.
Tipo de editor
Configurado EditorType para elegir entre ChoiceEditType.Dropdown (por defecto) o ChoiceEditType.RadioButtons. Al usar botones de radio, úsalo RadioButtonOrientation para controlar la disposición vertical u horizontal.
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.
Ejemplo
Un acotamiento básico ChoiceEdit a una columna de elección.
Opciones de configuración
Utiliza los controles a continuación para explorar las propiedades disponibles.
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? | |
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. |
Nombre:
ChildContentTipo:
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:
DescriptionTipo:
string?
Descripción:
La descripción se mostrará en la descripción emergente.
Nombre:
DisabledTipo:
bool?
Descripción:
¿Debería desactivar el editor?
Nombre:
DisplayLabelWhenAvailableTipo:
bool
Default:
True
Descripción:
Especifica si mostrar una lable si está disponible.
Nombre:
DisplayNullChoiceTipo:
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:
DisplayTooltipWhenAvailableTipo:
bool
Default:
True
Descripción:
Especifica si mostrar una descripción emergente si está disponible.
Nombre:
DisplayValidationErrorMessageTipo:
bool
Default:
True
Descripción:
¿Debe mostrarse un mensaje de error de validación cuando el componente falla en la validación?
Nombre:
EditorTypeTipo:
ChoiceEditType
Default:
Dropdown
Descripción:
Tipo de editor para renderizar
Nombre:
InvalidChoiceValuesTipo:
IEnumerable<int>?
Descripción:
Opcionalmente, especifica qué valores son inválidos.
Nombre:
InvalidValueBehaviorTipo:
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:
IsVisibleTipo:
bool
Default:
True
Descripción:
¿El editor es visible?
Nombre:
LabelTipo:
string?
Descripción:
El texto se mostrará como etiqueta para el editor.
Nombre:
RadioButtonOrientationTipo:
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:
ReadOnlyTipo:
bool?
Descripción:
¿Debería el editor ser solo lectura?
Nombre:
RequiredTipo:
bool?
Descripción:
Si el valor es necesario.
Nombre:
SortTipo:
ChoiceValueSort
Default:
Default
Descripción:
Determina cómo se ordenan los valores.
Nombre:
ValidChoiceValuesTipo:
IEnumerable<int>?
Descripción:
Opcionalmente, especifica qué valores son válidos.
Nombre:
ValueTipo:
int?
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:
ValueChangedTipo:
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:
GetValidationErrorsTipo:
List<string>
Descripción:
Devuelve una colección de los errores de validación actuales.