StorageFolder.CreateItemQueryWithOptions(QueryOptions) Método

Definição

Namespace:

Windows.Storage

Obtém um objeto de resultado de consulta que contém os arquivos e subpastas na pasta atual e, opcionalmente, nas subpastas da pasta atual. Os resultados são baseados nas QueryOptions especificadas.

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

Parâmetros

queryOptions

QueryOptions

Os critérios aplicados à consulta.

Retornos

StorageItemQueryResult

Um objeto de resultado da consulta. Chame o método GetItemsAsync do resultado da consulta para obter os arquivos e subpastas na pasta atual e, opcionalmente, nas subpastas da pasta atual, filtradas e classificadas com base nas QueryOptions especificadas. Esse método retorna uma lista do tipo IReadOnlyList<IStorageItem>. Cada arquivo ou pasta é representado por um item do tipo IStorageItem.

Para trabalhar com os itens retornados, chame o método IsOfType da interface IStorageItem para determinar se cada item é um arquivo ou uma pasta. Em seguida, converta o item em storageFolder ou StorageFile.

Implementações

CreateItemQueryWithOptions(QueryOptions)

Exceções

UnauthorizedAccessException

Você não tem permissão para acessar o conteúdo da pasta atual.

ArgumentException

Você especificou um valor diferente de DefaultQuery da <enumeração xref:Windows.Storage.Search.CommonFileQuery?text=CommonFileQuery> ou <xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery> para uma pasta que não é uma pasta de biblioteca.

Comentários

Para obter mais informações e exemplos sobre como obter objetos de resultado da consulta, consulte CreateFileQueryWithOptions.