LookupRecordContext

The LookupRecordContext component loads and provides editing access to the record referenced by a lookup field on the parent RecordContext. It inherits from BaseColumnEdit, so it binds to a column via the ColumnName parameter just like any other editor.

How It Works

When you place a LookupRecordContext inside a RecordContext and specify a ColumnName that maps to a lookup field, the component automatically reads the lookup value from the parent record, retrieves the referenced record from Dataverse, and exposes it as a nested RecordContext. Any editors placed inside the LookupRecordContext bind to the looked-up record's fields.

ColumnName

The ColumnName parameter must refer to a lookup column on the parent record. The component uses this to resolve the target table and record ID.

<RecordContext TableName="account" QueryParameterName="id">
    <LookupRecordContext ColumnName="primarycontactid">
        <ColumnEdit ColumnName="firstname" />
        <ColumnEdit ColumnName="lastname" />
        <ColumnEdit ColumnName="emailaddress1" />
    </LookupRecordContext>
</RecordContext>

Context Template

Like RecordContext, you can use the ContextTemplate parameter instead of ChildContent to access the looked-up TableRecord object directly in your markup.

<RecordContext TableName="account" QueryParameterName="id">
    <LookupRecordContext ColumnName="primarycontactid">
        <ContextTemplate>
            <h3>Primary Contact: @context["firstname"] @context["lastname"]</h3>
            <ColumnEdit ColumnName="emailaddress1" />
        </ContextTemplate>
    </LookupRecordContext>
</RecordContext>

Saving

Changes made to fields within a LookupRecordContext are saved as part of the parent MainContext save operation. The OnBeforeSave callback can be used to run custom logic or cancel the save.

<MainContext>
    <MenuBar>
        <SaveContextButton />
        <RefreshContextButton />
    </MenuBar>

    <RecordContext TableName="account" QueryParameterName="id">
        <ColumnEdit ColumnName="name" />

        <LookupRecordContext ColumnName="primarycontactid"
                              OnBeforeSave="OnBeforeSave">
            <ColumnEdit ColumnName="firstname" />
            <ColumnEdit ColumnName="lastname" />
        </LookupRecordContext>
    </RecordContext>
</MainContext>

@code {
    private async Task OnBeforeSave(CancelEventArgs eventArgs)
    {
        // Custom logic before saving the looked-up record
    }
}

Programmatic Access

The RecordContext property provides access to the inner RecordContext for programmatic operations such as refreshing or checking dirty state.

<LookupRecordContext @ref="_lookupContext" ColumnName="primarycontactid">
    <ColumnEdit ColumnName="firstname" />
</LookupRecordContext>

@code {
    private LookupRecordContext _lookupContext;

    private async Task RefreshContact()
    {
        await _lookupContext.RecordContext.RefreshAsync();
    }
}

Example

The following example shows an account form that displays the primary contact's details inline using a LookupRecordContext bound to the primarycontactid lookup field.

<MainContext>
    <MenuBar>
        <SaveContextButton />
        <RefreshContextButton />
    </MenuBar>

    <RecordContext TableName="account" QueryParameterName="accountId">
        <Section>
            <SectionColumn HeaderText="Account Info">
                <ColumnEdit ColumnName="name" />
                <LookupEdit ColumnName="primarycontactid" />
            </SectionColumn>
            <SectionColumn HeaderText="Primary Contact">
                <LookupRecordContext ColumnName="primarycontactid">
                    <ColumnEdit ColumnName="firstname" />
                    <ColumnEdit ColumnName="lastname" />
                    <ColumnEdit ColumnName="emailaddress1" />
                    <ImageEdit DisplayImage="true" ColumnName="ppp_profileimage" />
                </LookupRecordContext>
            </SectionColumn>
        </Section>
    </RecordContext>
</MainContext>