LookupRecordContext

LookupRecordContextコンポーネントは親RecordContextのルックアップフィールドで参照されたレコードを読み込み、編集アクセスを提供します。BaseColumnEditから継承するため、他のエディタと同様にColumnNameパラメータで列にバインドします。

仕組み

RecordContext内にLookupRecordContextを配置し、ルックアップフィールドにマッピングするColumnNameを指定すると、コンポーネントは親レコードからルックアップ値を自動で読み取り、Dataverseから参照されたレコードを取得し、それをネストRecordContextとして公開します。LookupRecordContext内に置かれたエディタは、検索したレコードのフィールドにバインドします。

列名

ColumnNameパラメータは親レコード上のルックアップカラムを参照しなければなりません。コンポーネントはこれを使ってターゲットテーブルとIDを記録します。

React

Blazor

コンテキストテンプレート

RecordContextと同様に、ChildContentの代わりにContextTemplateパラメータを使って、マークアップの対象TableRecord直接アクセスできます。

React

Blazor

貯蓄

LookupRecordContext内のフィールドの変更は、親のMainContextセーブ操作の一部として保存されます。OnBeforeSaveコールバックはカスタムロジックを実行したり、セーブをキャンセルしたりするために使えます。

React

Blazor

プログラムアクセス

RecordContextプロパティは、リフレッシュやダーティステートのチェックなどのプログラム操作のために内RecordContextへのアクセスを提供します。

React

Blazor

例

以下の例は、primarycontactid検索フィールドにバインドされたLookupRecordContextを使って、プライマリコンタクトの詳細をインラインで表示するアカウントフォームを示しています。

Reactの例

ブレイザーの例

アカウント

アカウント名

一次接触

React TypeScript

Razor

反応してください

ブレイザー

LookupRecordContext クラス

パラメータ

名称	種類	デフォルト	概要
`ChildContent`	RenderFragment?		コンポーネントの子コンテンツ
`ColumnName`*	string		テーブルレコードからエディタをバインドするための論理カラム名。
`ContextTemplate`	RenderFragment<TableRecord>		読み込まれたレコードを受け取ったフラグメントをレンダリングし、表示や編集を行います。
`Description`	string?		説明はツールチップに表示されます。
`Disabled`	bool?		エディターを無効にすべきか。
`DisplayLabelWhenAvailable`	bool	True	ラベルが可能であれば表示するかどうかを明記しています。
`DisplayTooltipWhenAvailable`	bool	True	ツールチップが表示されるかどうかを指定します。
`DisplayValidationErrorMessage`	bool	True	コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?
`IsVisible`	bool	True	エディターは見えますか?
`Label`	string?		編集者用のラベルとして表示されるテキスト。
`ReadOnly`	bool?		エディターは読み取り専用であるべきです。
`RecordContext`	RecordContext		プログラム操作のための内部 `LookupRecordContext.RecordContext` へのアクセスを提供します。
`Required`	bool?		価値が求められるかどうか。
`Value`	LookupValue?		このコンテキストで管理される現在のルックアップ値(参照)。

名称: ChildContent

種類: RenderFragment?

概要: コンポーネントの子コンテンツ

名称: ColumnName*

種類: string

概要: テーブルレコードからエディタをバインドするための論理カラム名。

名称: ContextTemplate

種類: RenderFragment<TableRecord>

概要: 読み込まれたレコードを受け取ったフラグメントをレンダリングし、表示や編集を行います。

名称: Description

種類: string?

概要: 説明はツールチップに表示されます。

名称: Disabled

種類: bool?

概要: エディターを無効にすべきか。

名称: DisplayLabelWhenAvailable

種類: bool

デフォルト: True

概要: ラベルが可能であれば表示するかどうかを明記しています。

名称: DisplayTooltipWhenAvailable

種類: bool

デフォルト: True

概要: ツールチップが表示されるかどうかを指定します。

名称: DisplayValidationErrorMessage

種類: bool

デフォルト: True

概要: コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?

名称: IsVisible

種類: bool

デフォルト: True

概要: エディターは見えますか?

名称: Label

種類: string?

概要: 編集者用のラベルとして表示されるテキスト。

名称: ReadOnly

種類: bool?

概要: エディターは読み取り専用であるべきです。

名称: RecordContext

種類: RecordContext

概要: プログラム操作のための内部 LookupRecordContext.RecordContext へのアクセスを提供します。

名称: Required

種類: bool?

概要: 価値が求められるかどうか。

名称: Value

種類: LookupValue?

概要: このコンテキストで管理される現在のルックアップ値(参照)。

イベント

名称	種類	概要
`OnBeforeSave`	EventCallback<CancelEventArgs>	コールバックから電話がかかってきて、セーブ前に電話がかかってきた。セーブ操作をキャンセルすることが可能です。
`ValueChanged`	EventCallback<ColumnValueBase>	バウンド値を更新するコールバックを取得または設定します。

名称: OnBeforeSave

種類: EventCallback<CancelEventArgs>

概要: コールバックから電話がかかってきて、セーブ前に電話がかかってきた。セーブ操作をキャンセルすることが可能です。

名称: ValueChanged

種類: EventCallback<ColumnValueBase>

概要: バウンド値を更新するコールバックを取得または設定します。

方法

名称	パラメータ	種類	概要
`GetValidationErrors`		List<string>	現在の検証エラーの集合を返します。

名称: GetValidationErrors

種類: List<string>

概要: 現在の検証エラーの集合を返します。