ITableMetadataCache

Der Dienst ITableMetadataCache bietet zwischengespeicherten Zugriff auf Metadaten der Dataverse-Tabellen. Es holt Tabellenmetadaten aus Dataverse beim ersten Zugriff ab und speichert sie für nachfolgende Anfragen, wodurch wiederholte Rundfahrten zum Server vermieden werden.

Verwendung

Injizieren ITableMetadataCache und rufen Sie mit dem logischen Namen der Tabelle auf. GetAsync Der erste Aufruf ruft die Metadaten aus Dataverse ab; nachfolgende Aufrufe geben den zwischengespeicherten Wert zurück.

React
Blazor

Was enthalten ist

Das zurückgegebene TableMetadata Objekt umfasst:

  • Columns — Eine Sammlung von Spaltenmetadaten, einschließlich Datentypen, Validierungsregeln, Beschriftungen und Einschränkungen.
  • PrimaryIdColumn / PrimaryNameColumn — Die logischen Namen der Spalten Primärschlüssel und Primärname der Tabelle.
  • OneToMany / ManyToOne / ManyToMany — Beziehungsmetadaten zur Navigation zwischen verwandten Tabellen.
  • PrimaryImageColumn — Der logische Name der primären Bildspalte der Tabelle, falls einer existiert.

Zugriff auf Spaltenmetadaten

Nutzen Sie die Sammlung, Columns um Metadaten für eine bestimmte Spalte nachzuschlagen. Für typspezifische Eigenschaften wie maximale Länge, Zieltabellen oder Optionswerte werden auf den entsprechenden Metadatentyp (z. B. StringMetadata, LookupMetadata, ChoiceMetadata) gecastet.

React
Blazor

Zugriff auf Beziehungsmetadaten

Verwenden Sie die , ManyToOne, und SammlungenOneToManyManyToMany, um Beziehungsmetadaten nach Beziehungsnamen nachzuschlagen. Dies wird intern von SubGrid und ManyToManyLookupEdit verwendet, um verwandte Tabellen zu lösen und Abfragen zu erstellen.

React
Blazor

Tipp

Bevorzuge ITableMetadataCache es für IPowerPortalsProService.RetrieveTableMetadataAsync Metadaten der Lesetabelle. Der Cache vermeidet redundante Netzwerkaufrufe und wird intern von allen PowerPortalsPro-Komponenten verwendet.

ITableMetadataCache Interface

Methoden

Name
Parameter
Typ
Beschreibung
GetAsyncstring key
CancellationToken token
Task<TableMetadata>
Ruft ein Element per Schlüssel aus dem Cache ab. Wenn das Element nicht zwischengespeichert ist, wird es aus der zugrunde liegenden Quelle abgerufen, zwischengespeichert und zurückgegeben.
Name: GetAsync
Parameter: string key
CancellationToken token
Typ: Task<TableMetadata>
Beschreibung: Ruft ein Element per Schlüssel aus dem Cache ab. Wenn das Element nicht zwischengespeichert ist, wird es aus der zugrunde liegenden Quelle abgerufen, zwischengespeichert und zurückgegeben.