StorageFolder.CreateItemQueryWithOptions(QueryOptions) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.