1. 読み込み設定

読み込み設定

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

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

この SDK は、読み込み設定と読み込みオプションを使用して以下の各設定を指定します。

  • エンティティを読み込む必要があるかどうか
  • どのカルチャにエンティティを読み込む必要があるか
  • どのメンバーでエンティティを読み込むか

[!注] 読み込み設定は にあります。Stylelabs.M.Framework.Essentials.LoadConfigurations. 読み込みオプションは Stylelabs.M.Framework.Essentials.LoadOptions にあります。

ヒント サーバーに対するオーバーヘッドを最小限に抑えるために、読み込みオプションと読み込み設定を使用して最小限の量のデータを読み込むようにします。

このセクションでは、最初にさまざまな読み込みオプションについて説明し、次に読み込みオプションを指定して読み込み設定を使用する方法を紹介します。

読み込みオプション

読み込みオプションは、特定のアイテムを読み込む方法を指定する "atomic 単位" です。 現在サポートされている読み込みオプションは次のとおりです。

  • カルチャ読み込みオプション
  • プロパティ読み込みオプション
  • リレーション読み込みオプション

どの読み込みオプションにも、一般的なユース ケース向けとして、既定のインスタンス、静的インスタンス、および読み取り専用インスタンスがあります。 また、読み込みオプションにはコピー コンストラクターもあります。 このコンストラクターを使用すると、読み取り専用の読み込みオプションをコピーして変更できます。

上記のすべての読み込みオプション クラスには、次の値を指定できる LoadOption (列挙型) プロパティがあります。

  • なし
  • 既定
  • カスタム
  • すべて

Custom に設定した場合、このオブジェクトでは、PropertyLoadOption のプロパティ名のリストを提供して、何を読み込むかを指定する必要があります。 LoadOptionCustom に設定していない場合、このリストは無視されます。

カルチャ読み込みオプション

既定のカルチャ読み込みオプションは次のとおりです。

  • CultureLoadOption.All: Sitecore Content Hub に登録されているすべてのカルチャを読み込みます。
  • CultureLoadOption.Default: Sitecore Content Hub で既定のカルチャを読み込みます。
  • CultureLoadOption.None: カルチャを読み込みません。

[!注] カルチャを指定せずにエンティティを読み込むと、そのエンティティにはカルチャに依存するプロパティが存在しません。

特定の複数のカルチャでエンティティを読み込むと、カルチャに依存するプロパティはそれらのカルチャでのみ使用できます。

特定の複数のカルチャを読み込むには、次のいずれかの方法を使用して新しい CultureLoadOption を作成します。

  • ロケール識別子 (LCID) をコンマ区切りで渡す。
この記事を改善するための提案がある場合は、 お知らせください!