遅延読み込み

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

エンティティにはプロパティとリレーションを遅延読み込みできます。これはサポートされている機能ですが、通常は必ず読み込みの適切な構成とオプションを使用して必要なメンバーを読み込むようにします。これにより、読み込みのオーバーヘッドを低減できます。

しかし、コンポーネント間でエンティティを受け渡す場合に、必要なメンバーがその場には存在しないことがあります。このような状況では遅延読み込みが効果的です。

メンバーを遅延読み込みする場合は、何らかの IO 処理によってサーバーからメンバーをフェッチします。つづいて、そのメンバーをエンティティのインスタンスに追加します。

1 つ以上のメンバーを遅延読み込みするには、必ずサーバーに対する呼び出しが必要になります。できるだけ多くの遅延読み込みをグループ化して 1 回で処理するようにします (以下を参照)。

遅延読み込みでは、必要なメンバーが存在するかどうかが必ず確認され、存在すれば IO 処理は実行されません。この SDK では、読み込み済みのメンバーは上書きされず、読み込まれていないメンバーのみが追加されます。

前提条件

メンバーを遅延読み込みするには、目的のエンティティが M に存在する必要があります。作成直後のエンティティのインスタンスにはメンバーの欠落がないので、そのインスタンスでのメンバーの遅延読み込みには意味がありません。

単一メンバーの遅延読み込み

プロパティを遅延読み込みして返す:

IProperty titleProperty = await entity.GetPropertyAsync("Title");

プロパティを遅延読み込みして、その値を直接返す:

string title = await titleProperty.GetPropertyValueAsync<string>("Title"));

リレーションを遅延読み込みして返す:

IRelation relation = await entity.GetRelationAsync("AssetTypeToAsset");

注意

これら以外にも、プロパティとリレーションを読み込むためのオーバーロードが多数あります。詳細な概要については、API のドキュメントを参照してください。

複数メンバーの遅延読み込み

1 回の呼び出しで複数のプロパティを遅延読み込みする:

var propertyLoadOption = new PropertyLoadOption("propertyName1", "propertyName2");
await entity.LoadPropertiesAsync(propertyLoadOption);

1 回の呼び出しで複数のリレーションを遅延読み込みする:

var relationLoadOption = new RelationLoadOption("relationName1", "relationName2");
await entity.LoadRelationsAsync(relationLoadOption);

1 回の呼び出しで複数のプロパティとリレーションの両方を遅延読み込みする:

var propertyLoadOption = new PropertyLoadOption("propertyName1", "propertyName2");
var relationLoadOption = new RelationLoadOption("relationName1", "relationName2");
await entity.LoadMembersAsync(propertyLoadOption, relationLoadOption);

この記事を改善するための提案がある場合は、お知らせください!