ITableMetadataCache

ITableMetadataCacheサービスはDataverseのテーブルメタデータへのキャッシュアクセスを提供します。Dataverseから初回アクセス時にテーブルメタデータを取得し、その後のリクエストのためにキャッシュし、サーバーへの繰り返しの往復を避けます。

使用例

ITableMetadataCacheを注入し、テーブルの論理名でGetAsyncを呼び出します。最初の呼び出しはDataverseからメタデータを取得します。その後の呼び出しはキャッシュされた値を返します。

React

Blazor

含まれるもの

返却された TableMetadata オブジェクトには以下が含まれます:

Columns — データ型、検証ルール、ラベル、制約を含む列メタデータの集合。
PrimaryIdColumn / PrimaryNameColumn — テーブルのプライマリキーおよびプライマリネームカラムの論理名。
OneToMany / ManyToOne / ManyToMany — 関連テーブル間のナビゲーションのための関係メタデータ。
PrimaryImageColumn — テーブルのプライマリ画像列(存在する場合)の論理名。

列メタデータへのアクセス

Columnsコレクションを使って特定の列のメタデータを調べてください。最大長さ、ターゲットテーブル、オプション値など型固有のプロパティに対して、適切なメタデータタイプ(例:StringMetadata、LookupMetadata、ChoiceMetadata)にキャストします。

React

Blazor

関係メタデータへのアクセス

OneToMany、ManyToOne、ManyToManyコレクションを使って、関係名で関係メタデータを調べてください。これは、社内でSubGridやManyToManyLookupEditが関連するテーブルを解決しクエリを構築するために使われています。

React

Blazor

ヒント
テーブルのメタデータを読むには ITableMetadataCache を IPowerPortalsProService.RetrieveTableMetadataAsync より好みます。キャッシュは冗長なネットワーク呼び出しを避け、すべてのPowerPortalsProコンポーネントで内部的に利用されます。

ITableMetadataCache Interface

方法

名称	パラメータ	種類	概要
`GetAsync`	string key CancellationToken token	Task<TableMetadata>	キーでキャッシュからアイテムを取得します。もしアイテムがキャッシュされていない場合は、基底のソースからフェッチされ、キャッシュされて返されます。

名称: GetAsync

パラメータ: string key
CancellationToken token

種類: Task<TableMetadata>

概要: キーでキャッシュからアイテムを取得します。もしアイテムがキャッシュされていない場合は、基底のソースからフェッチされ、キャッシュされて返されます。