ITableMetadataCache

O ITableMetadataCache serviço fornece acesso em cache aos metadados das tabelas do Dataverse. Ele recupera metadados das tabelas do Dataverse no primeiro acesso e os armazena em cache para requisições subsequentes, evitando viagens repetidas de ida e volta ao servidor.

Uso

Injete ITableMetadataCache e chame GetAsync com o nome lógico da mesa. A primeira chamada recupera os metadados do Dataverse; chamadas subsequentes retornam o valor em cache.

React
Blazor

O que está incluído

O objeto devolvido TableMetadata inclui:

  • Columns — Uma coleção de metadados de colunas incluindo tipos de dados, regras de validação, rótulos e restrições.
  • PrimaryIdColumn / PrimaryNameColumn — Os nomes lógicos das colunas da chave primária e do nome primário da tabela.
  • OneToMany / ManyToOne / ManyToMany — Metadados de relacionamento para navegar entre tabelas relacionadas.
  • PrimaryImageColumn — O nome lógico da coluna principal da imagem da tabela, caso exista.

Acessando Metadados de Coluna

Use a Columns coleção para buscar metadados de uma coluna específica. Caste para o tipo de metadado apropriado (ex StringMetadata.: , LookupMetadata, ) ChoiceMetadatapara propriedades específicas do tipo, como comprimento máximo, tabelas alvo ou valores de opção.

React
Blazor

Acessando Metadados de Relacionamento

Use as OneToManycoleções , ManyToOne, e ManyToMany para consultar metadados de relacionamento por nome de relacionamento. Isso é usado internamente por SubGrid e ManyToManyLookupEdit para resolver tabelas relacionadas e consultas de build.

React
Blazor

Dica

Prefiro ITableMetadataCache em vez IPowerPortalsProService.RetrieveTableMetadataAsync de ler metadados de tabelas. O cache evita chamadas de rede redundantes e é usado internamente por todos os componentes do PowerPortalsPro.

ITableMetadataCache Interface

Métodos

Nome
Parâmetros
Tipo
Descrição
GetAsyncstring key
CancellationToken token
Task<TableMetadata>
Recupera um item do cache por chave. Se o item não for armazenado em cache, ele é retirado da fonte subjacente, armazenado em cache e devolvido.
Nome: GetAsync
Parâmetros: string key
CancellationToken token
Tipo: Task<TableMetadata>
Descrição: Recupera um item do cache por chave. Se o item não for armazenado em cache, ele é retirado da fonte subjacente, armazenado em cache e devolvido.