ITableMetadataCache

The ITableMetadataCache service provides cached access to Dataverse table metadata. It retrieves table metadata from Dataverse on first access and caches it for subsequent requests, avoiding repeated round trips to the server.

Usage

Inject ITableMetadataCache and call GetAsync with the table's logical name. The first call retrieves the metadata from Dataverse; subsequent calls return the cached value.

What's Included

The returned TableMetadata object includes:

• Columns — A collection of column metadata including data types, validation rules, labels, and constraints.
• PrimaryIdColumn / PrimaryNameColumn — The logical names of the table's primary key and primary name columns.
• OneToMany / ManyToOne / ManyToMany — Relationship metadata for navigating between related tables.
• PrimaryImageColumn — The logical name of the table's primary image column, if one exists.

Accessing Column Metadata

Use the Columns collection to look up metadata for a specific column. Cast to the appropriate metadata type (e.g. StringMetadata, LookupMetadata, ChoiceMetadata) for type-specific properties like max length, target tables, or option values.

Accessing Relationship Metadata

Use the OneToMany, ManyToOne, and ManyToMany collections to look up relationship metadata by relationship name. This is used internally by SubGrid and ManyToManyLookupEdit to resolve related tables and build queries.

Tip

Prefer ITableMetadataCache over IPowerPortalsProService.RetrieveTableMetadataAsync for reading table metadata. The cache avoids redundant network calls and is used internally by all PowerPortalsPro components.