ITableMetadataCache

Le ITableMetadataCache service fournit un accès en cache aux métadonnées des tables Dataverse. Il récupère les métadonnées de table de Dataverse lors du premier accès et les met en cache pour les requêtes ultérieures, évitant ainsi les allers-retours répétés vers le serveur.

Utilisation

Injectez ITableMetadataCache et appelez GetAsync avec le nom logique de la table. Le premier appel récupère les métadonnées de Dataverse ; les appels suivants renvoient la valeur mise en cache.

React
Blazor

Ce qui est inclus

L’objet retourné TableMetadata comprend :

  • Columns — Une collection de métadonnées de colonnes incluant les types de données, les règles de validation, les étiquettes et les contraintes.
  • PrimaryIdColumn / PrimaryNameColumn — Les noms logiques des colonnes clés primaires et noms principaux du tableau.
  • OneToMany / ManyToOne / ManyToMany — Métadonnées de relations pour naviguer entre les tables associées.
  • PrimaryImageColumn — Le nom logique de la colonne principale image du tableau, si elle existe.

Accès aux métadonnées de colonnes

Utilisez la Columns collection pour rechercher les métadonnées d’une colonne spécifique. Castez vers le type de métadonnées approprié (par StringMetadataexemple , LookupMetadata, ChoiceMetadata) pour des propriétés spécifiques au type telles que la longueur maximale, les tables cibles ou les valeurs d’option.

React
Blazor

Accès aux métadonnées de la relation

Utilisez les OneToManycollections , ManyToOne, et ManyToMany pour rechercher les métadonnées de la relation par nom de la relation. Celle-ci est utilisée en interne par SubGrid et ManyToManyLookupEdit pour résoudre les tables et requêtes de compilation associées.

React
Blazor

Conseil

Préféré ITableMetadataCache plutôt IPowerPortalsProService.RetrieveTableMetadataAsync que pour lire les métadonnées des tableaux. Le cache évite les appels réseau redondants et est utilisé en interne par tous les composants PowerPortalsPro.

ITableMetadataCache Interface

Méthodes

Nom
Paramètres
Type
Description
GetAsyncstring key
CancellationToken token
Task<TableMetadata>
Récupère un élément du cache par clé. Si l’élément n’est pas mis en cache, il est récupéré depuis la source sous-jacente, mis en cache, puis retourné.
Nom: GetAsync
Paramètres: string key
CancellationToken token
Type: Task<TableMetadata>
Description: Récupère un élément du cache par clé. Si l’élément n’est pas mis en cache, il est récupéré depuis la source sous-jacente, mis en cache, puis retourné.