QueryOptions.SetPropertyPrefetch メソッド

定義

クエリの実行中にクエリ結果セット内のすべての項目に対してシステムが事前に読み込む必要があるプロパティを指定します (大文字と小文字を区別して取得する代わりに)。 多数のプロパティが指定されている場合、クエリの実行に時間がかかる場合がありますが、クエリ結果に対する後続のプロパティの取得は高速になります。

public:
 virtual void SetPropertyPrefetch(PropertyPrefetchOptions options, IIterable<Platform::String ^> ^ propertiesToRetrieve) = SetPropertyPrefetch;
void SetPropertyPrefetch(PropertyPrefetchOptions const& options, IIterable<winrt::hstring> const& propertiesToRetrieve);
public void SetPropertyPrefetch(PropertyPrefetchOptions options, IEnumerable<string> propertiesToRetrieve);
function setPropertyPrefetch(options, propertiesToRetrieve)
Public Sub SetPropertyPrefetch (options As PropertyPrefetchOptions, propertiesToRetrieve As IEnumerable(Of String))

パラメーター

options
PropertyPrefetchOptions

事前に取得するプロパティのセットを指定する 値。

使用可能なプロパティ セットは、 StorageFile クラスから使用できるプロパティのセットと一致します。 たとえば、 PropertyPrefetchOptions.BasicProperties、StorageFile.GetBasicPropertiesAsync で使用できるすべてのプロパティを事前に取得します。

propertiesToRetrieve

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

プロパティ名の配列として事前に取得するプロパティのカスタム リスト。 System.Copyright や System.Image.ColorSpace などのプロパティを指定するには、システム プロパティ名を使用します。

取得する追加のプロパティの一覧。

適用対象

こちらもご覧ください