StorageFolder.CreateItemQueryWithOptions(QueryOptions) Methode

Definition

Namespace:

Windows.Storage

Ruft ein Abfrageergebnisobjekt ab, das die Dateien und Unterordner im aktuellen Ordner und optional in den Unterordnern des aktuellen Ordners enthält. Die Ergebnisse basieren auf den angegebenen QueryOptions.

public:
 virtual StorageItemQueryResult ^ CreateItemQueryWithOptions(QueryOptions ^ queryOptions) = CreateItemQueryWithOptions;

StorageItemQueryResult CreateItemQueryWithOptions(QueryOptions const& queryOptions);

public StorageItemQueryResult CreateItemQueryWithOptions(QueryOptions queryOptions);

function createItemQueryWithOptions(queryOptions)

Public Function CreateItemQueryWithOptions (queryOptions As QueryOptions) As StorageItemQueryResult

Parameter

queryOptions

QueryOptions

Die Kriterien, die auf die Abfrage angewendet werden.

Gibt zurück

StorageItemQueryResult

Ein Abfrageergebnisobjekt. Rufen Sie die GetItemsAsync-Methode des Abfrageergebnisses auf, um die Dateien und Unterordner im aktuellen Ordner und optional in den Unterordnern des aktuellen Ordners abzurufen, gefiltert und basierend auf den angegebenen QueryOptions sortiert. Diese Methode gibt eine Liste vom Typ IReadOnlyList<IStorageItem> zurück. Jede Datei oder jeder Ordner wird durch ein Element vom Typ IStorageItem dargestellt.

Um mit den zurückgegebenen Elementen zu arbeiten, rufen Sie die IsOfType-Methode der IStorageItem-Schnittstelle auf, um zu bestimmen, ob es sich bei jedem Element um eine Datei oder einen Ordner handelt. Wandeln Sie das Element dann in einen StorageFolder oder StorageFile um.

Implementiert

CreateItemQueryWithOptions(QueryOptions)

Ausnahmen

UnauthorizedAccessException

Sie verfügen nicht über die Berechtigung, auf den Inhalt des aktuellen Ordners zuzugreifen.

ArgumentException

Sie haben einen anderen Wert als DefaultQuery aus der <xref:Windows.Storage.Search.CommonFileQuery?text=CommonFileQuery> - oder <xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery-Enumeration> für einen Ordner angegeben, der kein Bibliotheksordner ist.

Hinweise

Weitere Informationen und Beispiele zum Abrufen von Abfrageergebnisobjekten finden Sie unter CreateFileQueryWithOptions.