ProcurarRegistroContexto

O LookupRecordContext componente carrega e fornece acesso de edição ao registro referenciado por um campo de consulta no pai RecordContext. Ele herda de BaseColumnEdit, então ele se vincula a uma coluna via parâmetro ColumnName , assim como qualquer outro editor.

Como Funciona

Quando você coloca um LookupRecordContext dentro de um RecordContext e especifica um ColumnName que mapeia para um campo de pesquisa, o componente lê automaticamente o valor da consulta do registro pai, recupera o registro referenciado do Dataverse e o expõe como um campo aninhado RecordContext. Qualquer editor colocado dentro do LookupRecordContext bind para os campos do registro consultado.

Nome da Coluna

O ColumnName parâmetro deve se referir a uma coluna de consulta no registro pai. O componente usa isso para resolver a tabela de destino e o ID do registro.

React
Blazor

Modelo de Contexto

Por exemplo RecordContext, você pode usar o ContextTemplate parâmetro em vez de ChildContent acessar diretamente o objeto consultado TableRecord na sua marcação.

React
Blazor

Salvando

Alterações feitas nos campos dentro de um LookupRecordContext são salvas como parte da operação de salvamento pai MainContext . O OnBeforeSave callback pode ser usado para rodar lógica personalizada ou cancelar o save.

React
Blazor

Acesso Programático

A RecordContext propriedade oferece acesso ao interno RecordContext para operações programáticas, como atualizar ou verificar o estado sujo.

React
Blazor

Exemplo

O exemplo a seguir mostra um formulário de conta que exibe os dados do contato principal em linha usando um LookupRecordContext limite ao primarycontactid campo de consulta.

Exemplo de reação
Exemplo de Blazor
Conta
Contato Primário
React TypeScript
Razor
React Blazor

LookupRecordContext Classe

Parâmetros

Nome
Tipo
Padrão
Descrição
ChildContentRenderFragment?
Conteúdo filho do componente
ColumnName*string
Nome lógico da coluna para vincular o editor a partir do registro da tabela.
ContextTemplateRenderFragment<TableRecord>
Renderizar o fragmento que recebe o registro carregado para exibição ou edição.
Descriptionstring?
Descrição será exibida na dica de ferramenta.
Disabledbool?
Caso o editor esteja desativado.
DisplayLabelWhenAvailablebool
True
Especifica se deve exibir uma lable, se disponível.
DisplayTooltipWhenAvailablebool
True
Especifica se deve exibir uma dica de ferramenta, se disponível.
DisplayValidationErrorMessagebool
True
Uma mensagem de erro de validação deve ser exibida quando o componente falha na validação?
IsVisiblebool
True
O editor é visível?
Labelstring?
Texto para ser exibido como um rótulo para o editor.
ReadOnlybool?
O editor deve ser somente leitura.
RecordContextRecordContext
Fornece acesso ao interno LookupRecordContext.RecordContext para operações programáticas.
Requiredbool?
Se o valor for necessário.
ValueLookupValue?
O valor atual de consulta (referência) gerenciado por esse contexto.
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: ContextTemplate
Tipo: RenderFragment<TableRecord>
Descrição: Renderizar o fragmento que recebe o registro carregado para exibição ou edição.
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: 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: 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: ReadOnly
Tipo: bool?
Descrição: O editor deve ser somente leitura.
Nome: RecordContext
Tipo: RecordContext
Descrição: Fornece acesso ao interno LookupRecordContext.RecordContext para operações programáticas.
Nome: Required
Tipo: bool?
Descrição: Se o valor for necessário.
Nome: Value
Tipo: LookupValue?
Descrição: O valor atual de consulta (referência) gerenciado por esse contexto.

Eventos

Nome
Tipo
Descrição
OnBeforeSaveEventCallback<CancelEventArgs>
O retorno chamou antes de salvar. Permite cancelar a operação de salvamento.
ValueChangedEventCallback<ColumnValueBase>
Recebe ou define um callback que atualiza o valor vinculado.
Nome: OnBeforeSave
Tipo: EventCallback<CancelEventArgs>
Descrição: O retorno chamou antes de salvar. Permite cancelar a operação de salvamento.
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
GetValidationErrorsList<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.