StorageFolder.CreateItemQueryWithOptions(QueryOptions) Metodo

Definizione

Spazio dei nomi:

Windows.Storage

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.