Compartilhar via


StorageFolder.CreateItemQueryWithOptions(QueryOptions) Método

Definição

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

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

Exceções

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

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.

Aplica-se a