SubGrid

The SubGrid component displays Dataverse records related to a parent record via a specified relationship. It must be placed inside a RecordContext and requires a RelationshipName parameter that specifies which relationship to use.

Relationship Types

SubGrid supports both one-to-many (1:N) and many-to-many (N:N) relationships. The component automatically detects the relationship type and adjusts its behavior accordingly.

• For 1:N relationships, the grid displays records from the related table that reference the parent record. Toolbar buttons like NewRecordGridButton, EditRecordGridButton, and DeleteRecordGridButton are used to create, edit, and delete related records.
• For N:N relationships, the grid displays associated records. Toolbar buttons like LinkExistingRecordGridButton and UnlinkExistingRecordGridButton are used to associate and disassociate records. Create and delete operations are automatically converted to associate and disassociate requests.

Views

Use ViewIds to specify which views are available in the view selector dropdown, and DefaultViewId to set the initially selected view. If neither is provided, the grid automatically loads all public views for the related table. You can also provide CustomViewDefinitions with inline FetchXML to define views directly in code.

<SubGrid RelationshipName="contact_customer_accounts"
         ViewIds="_contactViews"
         DefaultViewId="@(new Guid("..."))">
</SubGrid>

@code {
    private List<Guid> _contactViews = new List<Guid>
    {
        new Guid("..."),
        new Guid("..."),
    };
}

Toolbar Buttons

Add buttons to the grid toolbar using the Buttons render fragment. See the Grid Buttons documentation for detailed configuration options including dialog positioning, wizard forms, and save behavior. The following built-in buttons are available:

• NewRecordGridButton — Opens a dialog form to create a new related record (1:N)
• EditRecordGridButton — Opens a dialog form to edit the selected record
• DeleteRecordGridButton — Deletes selected records
• LinkExistingRecordGridButton — Associates an existing record via a N:N relationship
• UnlinkExistingRecordGridButton — Disassociates selected records from a N:N relationship
• NavigateNewRecordGridButton — Navigates to a URL to create a new record
• NavigateEditRecordGridButton — Navigates to a URL to edit the selected record

<!-- 1:N relationship buttons -->
<SubGrid RelationshipName="contact_customer_accounts">
    <Buttons>
        <NewRecordGridButton TForm="NewContactForm" />
        <EditRecordGridButton TForm="EditContactForm" />
        <DeleteRecordGridButton />
    </Buttons>
</SubGrid>

<!-- N:N relationship buttons -->
<SubGrid RelationshipName="ppp_Account_ppp_Region_ppp_Region">
    <Buttons>
        <LinkExistingRecordGridButton />
        <UnlinkExistingRecordGridButton />
    </Buttons>
</SubGrid>

Inline Editing

Set AllowEdit="true" to enable a settings toggle that lets users switch to inline editing mode. When enabled, editable columns render as form controls directly in the grid. Inline editing is only supported for 1:N relationships.

<SubGrid RelationshipName="contact_customer_accounts"
         AllowEdit="true">
    <Buttons>
        <NewRecordGridButton TForm="NewContactForm" />
        <EditRecordGridButton TForm="EditContactForm" />
    </Buttons>
</SubGrid>

Paging & Search

The grid supports paged navigation with configurable page sizes via DefaultItemsPerPage and PageSizes. Search is enabled by default and can be disabled with AllowSearch="false".

<SubGrid RelationshipName="contact_customer_accounts"
         DefaultItemsPerPage="10"
         PageSizes="@(new[] { 10, 25, 50 })"
         AllowSearch="false">
</SubGrid>