LookupEdit

O LookupEdit componente gera uma coluna de consulta (referência) do Dataverse, permitindo que os usuários busquem e selecionem um registro relacionado.

React

Blazor

Tipo de Editor

Definido EditorType para escolher o estilo de renderização: LookupEditType.AutoComplete (padrão) fornece busca por digitar antecipadamente, LookupEditType.Dropdown mostra uma lista fixa e LookupEditType.RadioButtons exibe todas as opções como botões de opção.

React

Blazor

Opiniões

Use ViewIds para restringir quais visões estão disponíveis no diálogo de busca avançada. Use DefaultViewId para definir qual visualização será usada para busca. O ViewIds parâmetro é codificado Dictionary<string, List<Guid>> pelo nome da tabela, suportando consultas polimórficas que têm como alvo múltiplas tabelas.

React

Blazor

Consultas polimórficas

Para colunas de consulta que têm múltiplas tabelas, use DefaultTable para definir qual tabela está selecionada por padrão no seletor de tabela.

React

Blazor

Exemplo

Um limite básico LookupEdit a uma coluna de consulta.

Exemplo de reação

Exemplo de Blazor

Cliente Principal

React TypeScript

Razor

Opções de configuração

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

Exemplo de reação

Exemplo de Blazor

Somente leitura?

Obrigatório?

Deficiente?

Tabela padrão

Contato

Conta

Max Records Retornou

Tipo de Editor

AutoComplete

Menu suspenso

Botões de Rádio

Cliente Principal

React TypeScript

Razor

React

Blazor

LookupEdit 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.
`DefaultTable`	string?		Opcionalmente, especifique qual tabela deve ser definida como tabela padrão para pesquisa quando a busca estiver vinculado a um tipo de coluna cliente ou polimórfico.
`DefaultViewId`	Guid?		Especifique qual visualização deve ser usada para busca, caso contrário, a visualização de Busca será usada.
`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	True	Só aplicável quando os `LookupEdit.EditorType` == RadioButtons. Exibe um botão de rádio que representa um valor NULL.
`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`	LookupEditType	AutoComplete	Tipo de editor para renderizar e selecionar valores.
`IsVisible`	bool	True	O editor é visível?
`Label`	string?		Texto para ser exibido como um rótulo para o editor.
`MaxRecordsReturned`	int	20	Esse número máximo de registros para devolver ao consultar o Dataverse. Isso também limita os registros exibidos quando o `LookupEdit.EditorType` é igual a `LookupEditType.Dropdown` ou `LookupEditType.RadioButtons`.
`RadioButtonOrientation`	ComponentOrientation	Vertical	Orientação dos botões de rádio. Válido somente quando o `LookupEdit.EditorType` é definido para `ChoiceEditType.RadioButtons`.
`ReadOnly`	bool?		O editor deve ser somente leitura.
`Required`	bool?		Se o valor for necessário.
`Value`	LookupEditValue?		Obtém ou define o registro de busca atualmente selecionado pelo editor.
`ViewIds`	Dictionary<string, List<Guid>>?		Opcionalmente, restringa quais vistas podem ser exibidas no diálogo 'Busca Avançada'. A chave no dicionário é o nome da tabela.

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

Tipo: string?

Descrição: Opcionalmente, especifique qual tabela deve ser definida como tabela padrão para pesquisa quando a busca estiver vinculado a um tipo de coluna cliente ou polimórfico.

Nome: DefaultViewId

Tipo: Guid?

Descrição: Especifique qual visualização deve ser usada para busca, caso contrário, a visualização de Busca será usada.

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

Tipo: bool

Padrão: True

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

Nome: DisplayNullChoice

Tipo: bool

Padrão: True

Descrição: Só aplicável quando os LookupEdit.EditorType == RadioButtons. Exibe um botão de rádio que representa um valor NULL.

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

Padrão: AutoComplete

Descrição: Tipo de editor para renderizar e selecionar valores.

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

Tipo: int

Padrão: 20

Descrição: Esse número máximo de registros para devolver ao consultar o Dataverse. Isso também limita os registros exibidos quando o LookupEdit.EditorType é igual a LookupEditType.Dropdown ou LookupEditType.RadioButtons.

Nome: RadioButtonOrientation

Tipo: ComponentOrientation

Padrão: Vertical

Descrição: Orientação dos botões de rádio. Válido somente quando o LookupEdit.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: Value

Tipo: LookupEditValue?

Descrição: Obtém ou define o registro de busca atualmente selecionado pelo editor.

Nome: ViewIds

Tipo: Dictionary<string, List<Guid>>?

Descrição: Opcionalmente, restringa quais vistas podem ser exibidas no diálogo 'Busca Avançada'. A chave no dicionário é o nome da tabela.

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.