StorageFolder.CreateFolderQuery Método

Definição

Namespace:

Windows.Storage

Sobrecargas

CreateFolderQuery()	Obtém um objeto de resultado de consulta que contém as subpastas na pasta atual.
CreateFolderQuery(CommonFolderQuery)	Obtém um objeto de resultado de consulta que contém as subpastas na pasta atual. Quando o valor do argumento de consulta é algo diferente de CommonFolderQuery.DefaultQuery, obtém uma lista de pastas virtuais que representam contêineres para grupos de arquivos nas subpastas da pasta atual. Os arquivos são agrupados em pastas com base no valor especificado da enumeração CommonFolderQuery .

CreateFolderQuery()

Obtém um objeto de resultado de consulta que contém as subpastas na pasta atual.

public:
 virtual StorageFolderQueryResult ^ CreateFolderQuery() = CreateFolderQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFolderQueryOverloadDefault")]
StorageFolderQueryResult CreateFolderQuery();

[Windows.Foundation.Metadata.Overload("CreateFolderQueryOverloadDefault")]
public StorageFolderQueryResult CreateFolderQuery();

function createFolderQuery()

Public Function CreateFolderQuery () As StorageFolderQueryResult

Retornos

StorageFolderQueryResult

Um objeto de resultado da consulta. Chame o método GetFoldersAsync do resultado da consulta para obter as subpastas na pasta atual. Esse método retorna uma lista do tipo IReadOnlyList<StorageFolder>. Cada arquivo ou pasta é representado por um item do tipo StorageFolder.

Implementações

CreateFolderQuery()

Atributos

OverloadAttribute

Exceções

UnauthorizedAccessException

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

Exemplos

O exemplo a seguir mostra como obter o conteúdo das subpastas na pasta Imagens do usuário, agrupadas em pastas por mês, chamando o método sobrecarregado GetFoldersAsync(CommonFolderQuery ). (Os arquivos da raiz da pasta atual não estão incluídos.)

Antes de executar o exemplo a seguir, habilite a funcionalidade Biblioteca de Imagens no arquivo de manifesto do aplicativo.

using Windows.Storage;
using Windows.Storage.Search;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to the Output window.

// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;

// Get the files in the subfolders of the
// user's Pictures folder, grouped by month.
StorageFolderQueryResult groupedItems =
    picturesFolder.CreateFolderQuery(CommonFolderQuery.GroupByMonth);

// Iterate over the results and print the list of folders
// and files to the Visual Studio Output window.
foreach (StorageFolder folder in await groupedItems.GetFoldersAsync())
{
    Debug.WriteLine(folder.Name);

// To iterate over the files in each folder,
// uncomment the following lines.
// foreach(StorageFile file in await folder.GetFilesAsync())
//    Debug.WriteLine(" " + file.Name);
}

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the users's Pictures folder.
    // Enable the Pictures Library capability in the app manifest file.
    Windows::Storage::StorageFolder picturesFolder{ Windows::Storage::KnownFolders::PicturesLibrary() };

    // Get the files in the user's Pictures folder, and group them by month.
    Windows::Storage::Search::StorageFolderQueryResult results{ picturesFolder.CreateFolderQuery(Windows::Storage::Search::CommonFolderQuery::GroupByMonth) };

    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFolder> itemsInFolder{
        co_await results.GetFoldersAsync() };

    // Iterate over the results, and print the list of file groups to the Visual Studio output window.
    for (StorageFolder const& itemInFolder : itemsInFolder)
    {
        std::wstring output{ itemInFolder.Name() };
        ::OutputDebugString(output.c_str());
    }
}

// Get user's pictures folder
StorageFolder^ picturesFolder = KnownFolders::PicturesLibrary;

// Get the files in the user's Pictures folder and group them by month
StorageFolderQueryResult^ itemsInFolder = picturesFolder->CreateFolderQuery(CommonFolderQuery::GroupByMonth);

create_task(itemsInFolder->GetFoldersAsync()).then([=](IVectorView<StorageFolder^>^ itemsInFolder) {
 //Iterate over the results and print the list of file groups
 // to the visual studio output window
 for (auto it = itemsInFolder->First(); it->HasCurrent; it->MoveNext())
 {
  StorageFolder^ file = it->Current;
  String^ output = file->Name + "\n";
  OutputDebugString(output->Begin());
 }
});

Comentários

Essa consulta é uma consulta superficial que retorna apenas subpastas na pasta atual. Para obter uma lista de métodos que identifica consultas superficiais e consultas profundas, consulte os Comentários no método GetFoldersAsync .

Para especificar opções de consulta adicionais, chame o método CreateFolderQueryWithOptions .

Para obter itens que são arquivos ou pastas, chame o método CreateItemQuery .

Confira também

• CreateFolderQuery(CommonFolderQuery)

CreateFolderQuery(CommonFolderQuery)

Obtém um objeto de resultado de consulta que contém as subpastas na pasta atual. Quando o valor do argumento de consulta é algo diferente de CommonFolderQuery.DefaultQuery, obtém uma lista de pastas virtuais que representam contêineres para grupos de arquivos nas subpastas da pasta atual. Os arquivos são agrupados em pastas com base no valor especificado da enumeração CommonFolderQuery .

public:
 virtual StorageFolderQueryResult ^ CreateFolderQuery(CommonFolderQuery query) = CreateFolderQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFolderQuery")]
StorageFolderQueryResult CreateFolderQuery(CommonFolderQuery const& query);

[Windows.Foundation.Metadata.Overload("CreateFolderQuery")]
public StorageFolderQueryResult CreateFolderQuery(CommonFolderQuery query);

function createFolderQuery(query)

Public Function CreateFolderQuery (query As CommonFolderQuery) As StorageFolderQueryResult

Parâmetros

query

CommonFolderQuery

Um dos valores de enumeração que especifica como agrupar os arquivos em pastas e determina se a consulta é superficial ou profunda.

Retornos

StorageFolderQueryResult

Um objeto de resultado da consulta. Chame o método GetFoldersAsync do resultado da consulta para obter as subpastas na pasta atual. Quando o valor do argumento de consulta é algo diferente de CommonFolderQuery.DefaultQuery, o objeto de resultado da consulta contém uma lista de pastas virtuais que representam contêineres para grupos de arquivos nas subpastas da pasta atual. (Os arquivos da pasta atual não estão incluídos.) Os arquivos são agrupados conforme especificado pela consulta. A lista é do tipo IReadOnlyList<StorageFolder>. Cada pasta na lista é representada por um objeto StorageFolder .

Implementações

CreateFolderQuery(CommonFolderQuery)

Atributos

OverloadAttribute

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.CommonFolderQuery?text=CommonFolderQuery> para uma pasta que não é uma pasta de biblioteca. Verifique o valor da consulta.

Comentários

Uma CommonFolderQuery agrupa o conteúdo de subpastas em pastas com base em atributos de arquivo específicos (como artista ou álbum) de forma rápida e fácil. Consulte os Comentários na página do método CreateFileQuery para obter mais informações sobre como especificar opções DefaultQuery .

Confira também

• CreateFolderQuery()