StorageFolder.CreateItemQueryWithOptions(QueryOptions) Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage

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.

Modifica

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 StorageItemQueryResult

Parametri

queryOptions: QueryOptions

Criteri applicati alla query.

Restituisce

StorageItemQueryResult

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

CreateItemQueryWithOptions(QueryOptions)

Eccezioni

UnauthorizedAccessException

Non si dispone dell'autorizzazione per accedere al contenuto della cartella corrente.

ArgumentException

È 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.

Si applica a

Condividi tramite