StorageFolder.CreateItemQueryWithOptions(QueryOptions) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un oggetto risultato della query contenente i file e le sottocartelle nella cartella corrente e, facoltativamente, nelle sottocartelle della cartella corrente. I risultati sono basati su QueryOptions specificati.
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 StorageItemQueryResultParametri
- queryOptions
- QueryOptions
Criteri applicati alla query.
Restituisce
Oggetto risultato query. Chiamare il metodo GetItemsAsync del risultato della query per ottenere i file e le sottocartelle nella cartella corrente e, facoltativamente, nelle sottocartelle della cartella corrente, filtrate e ordinate in base alle opzioni query specificate. Questo metodo restituisce un elenco di tipo IReadOnlyList<IStorageItem>. Ogni file o cartella è rappresentato da un elemento di tipo IStorageItem.
Per usare gli elementi restituiti, chiamare il metodo IsOfType dell'interfaccia IStorageItem per determinare se ogni elemento è un file o una cartella. Eseguire quindi il cast dell'elemento in un oggetto StorageFolder o StorageFile.
Implementazioni
Eccezioni
Non si dispone dell'autorizzazione per accedere al contenuto della cartella corrente.
È stato specificato un valore diverso da DefaultQuery dall'enumerazione <xref:Windows.Storage.Search.CommonFileQuery?text=CommonFileQuery> o <xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery> per una cartella che non è una cartella.
Commenti
Per altre informazioni ed esempi sull'acquisizione di oggetti risultato query, vedere CreateFileQueryWithOptions.