ChoiceEdit
O ChoiceEdit componente gera uma coluna de escolha do Dataverse (conjunto de opções/lista de seleção) como um menu suspenso ou grupo de botões de rádio para seleção de valor único.
Tipo de Editor
Defina EditorType para escolher entre ChoiceEditType.Dropdown (padrão) ou ChoiceEditType.RadioButtons. Ao usar botões de rádio, use RadioButtonOrientation para controlar o layout vertical ou horizontal.
Ordem de Ordenação
Configura SortOrder para controlar como as opções são ordenadas. As opções incluem Default (ordem do Dataverse), DisplayName, DisplayNameDescending, Value, e ValueDescending.
Exemplo
Um limite básico ChoiceEdit a uma coluna de escolha.
Opções de configuração
Use os controles abaixo para explorar as propriedades disponíveis.
ChoiceEdit 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. | |
DisplayLabelWhenAvailable | bool | True | Especifica se deve exibir uma lable, se disponível. |
DisplayNullChoice | bool? | Se deve mostrar uma opção '(nenhuma)' que limpa a coluna de volta para nula. Quando omitido, o padrão é obrigatório-consciente: uma coluna obrigatória o esconde (o usuário deve escolher um valor real); uma coluna não obrigatória mostra isso. Cenário explicitamente para sobrepor qualquer um dos padrão. | |
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? |
EditorType | ChoiceEditType | Dropdown | Tipo de editor a ser renderizado |
InvalidChoiceValues | IEnumerable<int>? | Opcionalmente, especifique quais valores são inválidos. | |
InvalidValueBehavior | ChoiceInvalidValueBehavior | Remove | Determina o comportamento de valores inválidos. Aplicável somente quando o BaseChoiceEditCommon.ValidChoiceValues parâmetro ou BaseChoiceEditCommon.InvalidChoiceValues é fornecido. |
IsVisible | bool | True | O editor é visível? |
Label | string? | Texto para ser exibido como um rótulo para o editor. | |
RadioButtonOrientation | ComponentOrientation | Vertical | Orientação dos botões de rádio. Válido somente quando o BaseChoiceEdit.EditorType é definido para ChoiceEditType.RadioButtons. |
ReadOnly | bool? | O editor deve ser somente leitura. | |
Required | bool? | Se o valor for necessário. | |
Sort | ChoiceValueSort | Default | Determina como os valores são organizados. |
ValidChoiceValues | IEnumerable<int>? | Opcionalmente, especifique quais valores são válidos. | |
Value | int? | Valor da coluna. |
Nome:
ChildContentTipo:
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:
DescriptionTipo:
string?
Descrição:
Descrição será exibida na dica de ferramenta.
Nome:
DisabledTipo:
bool?
Descrição:
Caso o editor esteja desativado.
Nome:
DisplayLabelWhenAvailableTipo:
bool
Padrão:
True
Descrição:
Especifica se deve exibir uma lable, se disponível.
Nome:
DisplayNullChoiceTipo:
bool?
Descrição:
Se deve mostrar uma opção '(nenhuma)' que limpa a coluna de volta para nula. Quando omitido, o padrão é obrigatório-consciente: uma coluna obrigatória o esconde (o usuário deve escolher um valor real); uma coluna não obrigatória mostra isso. Cenário explicitamente para sobrepor qualquer um dos padrão.
Nome:
DisplayTooltipWhenAvailableTipo:
bool
Padrão:
True
Descrição:
Especifica se deve exibir uma dica de ferramenta, se disponível.
Nome:
DisplayValidationErrorMessageTipo:
bool
Padrão:
True
Descrição:
Uma mensagem de erro de validação deve ser exibida quando o componente falha na validação?
Nome:
EditorTypeTipo:
ChoiceEditType
Padrão:
Dropdown
Descrição:
Tipo de editor a ser renderizado
Nome:
InvalidChoiceValuesTipo:
IEnumerable<int>?
Descrição:
Opcionalmente, especifique quais valores são inválidos.
Nome:
InvalidValueBehaviorTipo:
ChoiceInvalidValueBehavior
Padrão:
Remove
Descrição:
Determina o comportamento de valores inválidos. Aplicável somente quando o
BaseChoiceEditCommon.ValidChoiceValues parâmetro ou BaseChoiceEditCommon.InvalidChoiceValues é fornecido.Nome:
IsVisibleTipo:
bool
Padrão:
True
Descrição:
O editor é visível?
Nome:
LabelTipo:
string?
Descrição:
Texto para ser exibido como um rótulo para o editor.
Nome:
RadioButtonOrientationTipo:
ComponentOrientation
Padrão:
Vertical
Descrição:
Orientação dos botões de rádio. Válido somente quando o
BaseChoiceEdit.EditorType é definido para ChoiceEditType.RadioButtons.Nome:
ReadOnlyTipo:
bool?
Descrição:
O editor deve ser somente leitura.
Nome:
RequiredTipo:
bool?
Descrição:
Se o valor for necessário.
Nome:
SortTipo:
ChoiceValueSort
Padrão:
Default
Descrição:
Determina como os valores são organizados.
Nome:
ValidChoiceValuesTipo:
IEnumerable<int>?
Descrição:
Opcionalmente, especifique quais valores são válidos.
Nome:
ValueTipo:
int?
Descrição:
Valor da coluna.
Eventos
Nome | Tipo | Descrição |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | Recebe ou define um callback que atualiza o valor vinculado. |
Nome:
ValueChangedTipo:
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:
GetValidationErrorsTipo:
List<string>
Descrição:
Retorna uma coleção dos erros de validação atuais.