StorageFolder.CreateItemQueryWithOptions(QueryOptions) Methode

Referenz

Definition

Namespace:: Windows.Storage

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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.

Gilt für:

Freigeben über