ManyToManyLookupEdit

O ManyToManyLookupEdit componente fornece um editor de autopreenchimento inline para gerenciar relações muitos-para-muitos (N:N) entre registros do Dataverse. Ele exibe os registros atualmente associados como chips e permite que os usuários pesquisem, adicionem e removam associações sem precisar sair do formulário.

Como Funciona

Coloque o componente dentro de a RecordContext e especifique o RelationshipName. O componente resolve automaticamente a tabela relacionada, carrega os registros associados e fornece um menu suspenso de autopreenchimento pesquisável para adicionar novas associações.

React

Blazor

Opiniões

Use ViewIds e DefaultViewId para controlar quais visualizações estão disponíveis para busca em registros relacionados. As colunas da visualização são exibidas no menu suspenso para ajudar os usuários a identificar o registro correto. Se nenhuma visualização for especificada, a visualização pública padrão para a tabela relacionada é utilizada.

React

Blazor

Validação

Use MinimumNumberOfItems e MaximumNumberOfItems para impor restrições ao número de registros associados. Definir um mínimo marca automaticamente o campo como necessário.

React

Blazor

Salvando

As mudanças são acompanhadas como solicitações pendentes de associados e dissociações. Quando o pai MainContext é salvo, essas solicitações são incluídas na operação de salvamento transacional junto com quaisquer outras alterações de registro.

React

Blazor

Exemplo

O exemplo a seguir mostra um vínculo básico ManyToManyLookupEdit para uma relação muitos-para-muitos.

Exemplo de reação

Exemplo de Blazor

Regiões

React TypeScript

Razor

Opções de configuração

Use os controles abaixo para explorar as ReadOnlypropriedades , Disabled, MinimumNumberOfItems, e MaximumNumberOfItems .

Exemplo de reação

Exemplo de Blazor

Somente leitura?

Deficiente?

Min

Max

Regiões

React TypeScript

Razor

React

Blazor

ManyToManyLookupEdit Classe

Parâmetros

Nome	Tipo	Padrão	Descrição
`ChildContent`	RenderFragment?		Conteúdo filho do componente
`Context`	MainContext?		Contexto em cascata que registra este editor para operações de salvamento coordenadas.
`DefaultViewId`	Guid?		Especifica qual visualização deve ser usada como padrão ao navegar por registros relacionados.
`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.
`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?
`IsDirty`	bool	False	Recebe um valor indicando se há mudanças pendentes de associação ou dissociação que ainda não foram salvas.
`IsVisible`	bool	True	O editor é visível?
`Label`	string?		Texto para ser exibido como um rótulo para o editor.
`MaximumNumberOfItems`	int?		Número máximo de registros relacionados que podem ser selecionados.
`MaxRecordsReturned`	int	20	Número máximo de registros retornados do Dataverse ao buscar registros relacionados.
`MinimumNumberOfItems`	int?		Número mínimo de registros relacionados que devem ser selecionados para que o editor seja considerado válido.
`ReadOnly`	bool?		O editor deve ser somente leitura.
`RelationshipName`*	string		O nome de relacionamento muitos-para-muitos do Dataverse que este editor gerencia.
`Required`	bool?		Se o valor for necessário.
`ViewIds`	List<Guid>?		Limites de quais visualizações estão disponíveis para navegar por registros relacionados; se estiver vazia, a visualização pública padrão é usada.

Nome: ChildContent

Tipo: RenderFragment?

Descrição: Conteúdo filho do componente

Nome: Context

Tipo: MainContext?

Descrição: Contexto em cascata que registra este editor para operações de salvamento coordenadas.

Nome: DefaultViewId

Tipo: Guid?

Descrição: Especifica qual visualização deve ser usada como padrão ao navegar por registros relacionados.

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

Tipo: bool

Padrão: False

Descrição: Recebe um valor indicando se há mudanças pendentes de associação ou dissociação que ainda não foram salvas.

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

Tipo: int?

Descrição: Número máximo de registros relacionados que podem ser selecionados.

Nome: MaxRecordsReturned

Tipo: int

Padrão: 20

Descrição: Número máximo de registros retornados do Dataverse ao buscar registros relacionados.

Nome: MinimumNumberOfItems

Tipo: int?

Descrição: Número mínimo de registros relacionados que devem ser selecionados para que o editor seja considerado válido.

Nome: ReadOnly

Tipo: bool?

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

Nome: RelationshipName*

Tipo: string

Descrição: O nome de relacionamento muitos-para-muitos do Dataverse que este editor gerencia.

Nome: Required

Tipo: bool?

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

Nome: ViewIds

Tipo: List<Guid>?

Descrição: Limites de quais visualizações estão disponíveis para navegar por registros relacionados; se estiver vazia, a visualização pública padrão é usada.

Métodos

Nome	Parâmetros	Tipo	Descrição
`GetRequests`		List<OrganizationRequest>	Retorna as operações pendentes `Requests.OrganizationRequest` (associar e dissociar) que precisam ser executadas para persistir a seleção atual.
`GetValidationErrors`		List<string>	Devolve erros de validação para a seleção atual, incluindo violações das regras de contagem mínima e máxima de itens.
`RefreshAsync`	bool forceRefresh	Task	Instrui a grade a buscar novamente e renderizar os dados atuais da fonte de dados fornecida.
`ResetState`		void	Elimina todas as alterações pendentes de associação e dissociação, resetando o editor para seu último estado salvo.
`Validate`		bool	Retorna verdadeiro quando a seleção atual satisfaz as restrições de número mínimo e máximo de itens configuradas.

Nome: GetRequests

Tipo: List<OrganizationRequest>

Descrição: Retorna as operações pendentes Requests.OrganizationRequest (associar e dissociar) que precisam ser executadas para persistir a seleção atual.

Nome: GetValidationErrors

Tipo: List<string>

Descrição: Devolve erros de validação para a seleção atual, incluindo violações das regras de contagem mínima e máxima de itens.

Nome: RefreshAsync

Parâmetros: bool forceRefresh

Tipo: Task

Descrição: Instrui a grade a buscar novamente e renderizar os dados atuais da fonte de dados fornecida.

Nome: ResetState

Tipo: void

Descrição: Elimina todas as alterações pendentes de associação e dissociação, resetando o editor para seu último estado salvo.

Nome: Validate

Tipo: bool

Descrição: Retorna verdadeiro quando a seleção atual satisfaz as restrições de número mínimo e máximo de itens configuradas.