Account
Primary Contact
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.
Context Template
Like RecordContext, you can use the ContextTemplate parameter instead of ChildContent to access the looked-up TableRecord object directly in your markup.
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.
Programmatic Access
The RecordContext property provides access to the inner RecordContext for programmatic operations such as refreshing or checking dirty state.
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.
LookupRecordContext Class
Parameters
Name | Type | Default | Description |
|---|---|---|---|
ChildContent | RenderFragment? | Child content of the component | |
ColumnName* | string | Column logical name to bind the editor to from the table record. | |
ContextTemplate | RenderFragment<TableRecord> | Render fragment that receives the loaded record for display or editing. | |
Description | string? | Description to be displayed in the tooltip. | |
Disabled | bool? | Should the editor be disabled. | |
DisplayLabelWhenAvailable | bool | True | Specifies whether to display a lable if available. |
DisplayTooltipWhenAvailable | bool | True | Specifies whether to display a tooltip if available. |
DisplayValidationErrorMessage | bool | True | Should a validation error message be displayed when the component fails validation? |
IsVisible | bool | True | Is the editor visible. |
Label | string? | Text to be displayed as a label for the editor. | |
ReadOnly | bool? | Should the editor be read-only. | |
RecordContext | RecordContext | Provides access to the inner LookupRecordContext.RecordContext for programmatic operations. | |
Required | bool? | Should the value be required. | |
Value | LookupValue? | The current lookup value (reference) managed by this context. |
Name:
ChildContentType:
RenderFragment?
Description:
Child content of the component
Name:
ColumnName*Type:
string
Description:
Column logical name to bind the editor to from the table record.
Name:
ContextTemplateType:
RenderFragment<TableRecord>
Description:
Render fragment that receives the loaded record for display or editing.
Name:
DescriptionType:
string?
Description:
Description to be displayed in the tooltip.
Name:
DisabledType:
bool?
Description:
Should the editor be disabled.
Name:
DisplayLabelWhenAvailableType:
bool
Default:
True
Description:
Specifies whether to display a lable if available.
Name:
DisplayTooltipWhenAvailableType:
bool
Default:
True
Description:
Specifies whether to display a tooltip if available.
Name:
DisplayValidationErrorMessageType:
bool
Default:
True
Description:
Should a validation error message be displayed when the component fails validation?
Name:
IsVisibleType:
bool
Default:
True
Description:
Is the editor visible.
Name:
LabelType:
string?
Description:
Text to be displayed as a label for the editor.
Name:
ReadOnlyType:
bool?
Description:
Should the editor be read-only.
Name:
RecordContextType:
RecordContext
Description:
Provides access to the inner
LookupRecordContext.RecordContext for programmatic operations.Name:
RequiredType:
bool?
Description:
Should the value be required.
Name:
ValueType:
LookupValue?
Description:
The current lookup value (reference) managed by this context.
Events
Name | Type | Description |
|---|---|---|
OnBeforeSave | EventCallback<CancelEventArgs> | Callback called before saving. Allows for cancelling the save operation. |
ValueChanged | EventCallback<ColumnValueBase> | Gets or sets a callback that updates the bound value. |
Name:
OnBeforeSaveType:
EventCallback<CancelEventArgs>
Description:
Callback called before saving. Allows for cancelling the save operation.
Name:
ValueChangedType:
EventCallback<ColumnValueBase>
Description:
Gets or sets a callback that updates the bound value.
Methods
Name | Parameters | Type | Description |
|---|---|---|---|
GetValidationErrors | List<string> | Returns a collection of the current validation errors. |
Name:
GetValidationErrorsType:
List<string>
Description:
Returns a collection of the current validation errors.