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.

React

Blazor

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. Botões de rádio horizontais se enrolam na próxima fileira quando acabam o espaço; configurado WrapRadioButtons para false rolar a página.

React

Blazor

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.

React

Blazor

Exemplo

Um limite básico ChoiceEdit a uma coluna de escolha.

Exemplo de reação

Exemplo de Blazor

React TypeScript

Razor

Cor Favorita

(Selecione um valor)

Vermelho

Azul

Laranja

Roxo

Amarelo

Preto

Branco

Brown

Verde

Opções de configuração

Use os controles abaixo para explorar as propriedades disponíveis.

Exemplo de reação

Exemplo de Blazor

React TypeScript

Razor

Somente leitura?

Obrigatório?

Deficiente?

Cores de escolha de display?

Ordem de Ordenação

Padrão

Nome de Exibição

Nome de Exibição Decrescente

Valor

Valor Descendente

Comportamento de Valor Inválido

Desabilitar

Remover

Escolha Nula

Padrão (Auto)

Programa

Esconder

Tipo

Menu suspenso

Botões de Rádio

Cor Favorita

(Selecione um valor)

Vermelho

Azul

Laranja

Roxo

Amarelo

Preto

Branco

Brown

Verde

React

Blazor

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.
`DisplayChoiceColors`	bool	False	Quando é verdadeiro, uma pequena amostra da cor que cada opção é dada no Dataverse é mostrada ao lado dele, e ao lado do valor selecionado de um menu suspenso fechado. Opções sem cor obter Um espaço vazio, então as etiquetas ainda estão alinhadas. O padrão é falso.
`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.
`WrapRadioButtons`	bool	True	Quando é verdadeiro (o padrão), os botões de rádio horizontais que ficam sem espaço se encaixam no próxima linha; quando falsas, elas permanecem em uma fileira, que rola. Não tem efeito nas fileiras verticais.

Nome: ChildContent

Tipo: 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: Description

Tipo: string?

Descrição: Descrição será exibida na dica de ferramenta.

Nome: Disabled

Tipo: bool?

Descrição: Caso o editor esteja desativado.

Nome: DisplayChoiceColors

Tipo: bool

Padrão: False

Descrição: Quando é verdadeiro, uma pequena amostra da cor que cada opção é dada no Dataverse é mostrada ao lado dele, e ao lado do valor selecionado de um menu suspenso fechado. Opções sem cor obter Um espaço vazio, então as etiquetas ainda estão alinhadas. O padrão é falso.

Nome: DisplayLabelWhenAvailable

Tipo: bool

Padrão: True

Descrição: Especifica se deve exibir uma lable, se disponível.

Nome: DisplayNullChoice

Tipo: 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: DisplayTooltipWhenAvailable

Tipo: bool

Padrão: True

Descrição: Especifica se deve exibir uma dica de ferramenta, se disponível.

Nome: DisplayValidationErrorMessage

Tipo: bool

Padrão: True

Descrição: Uma mensagem de erro de validação deve ser exibida quando o componente falha na validação?

Nome: EditorType

Tipo: ChoiceEditType

Padrão: Dropdown

Descrição: Tipo de editor a ser renderizado

Nome: InvalidChoiceValues

Tipo: IEnumerable<int>?

Descrição: Opcionalmente, especifique quais valores são inválidos.

Nome: InvalidValueBehavior

Tipo: 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: IsVisible

Tipo: bool

Padrão: True

Descrição: O editor é visível?

Nome: Label

Tipo: string?

Descrição: Texto para ser exibido como um rótulo para o editor.

Nome: RadioButtonOrientation

Tipo: 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: ReadOnly

Tipo: bool?

Descrição: O editor deve ser somente leitura.

Nome: Required

Tipo: bool?

Descrição: Se o valor for necessário.

Nome: Sort

Tipo: ChoiceValueSort

Padrão: Default

Descrição: Determina como os valores são organizados.

Nome: ValidChoiceValues

Tipo: IEnumerable<int>?

Descrição: Opcionalmente, especifique quais valores são válidos.

Nome: Value

Tipo: int?

Descrição: Valor da coluna.

Nome: WrapRadioButtons

Tipo: bool

Padrão: True

Descrição: Quando é verdadeiro (o padrão), os botões de rádio horizontais que ficam sem espaço se encaixam no próxima linha; quando falsas, elas permanecem em uma fileira, que rola. Não tem efeito nas fileiras verticais.

Eventos

Nome	Tipo	Descrição
`ValueChanged`	EventCallback<ColumnValueBase>	Recebe ou define um callback que atualiza o valor vinculado.

Nome: ValueChanged

Tipo: 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: GetValidationErrors

Tipo: List<string>

Descrição: Retorna uma coleção dos erros de validação atuais.