Partilhar via


StorageFolderQueryResult Classe

Definição

Fornece acesso aos resultados de uma consulta que lista a pasta (ou grupos de arquivos) na pasta que está sendo consultada (que é representada por um StorageFolder). Você pode usar um StorageFolderQueryResult para enumerar pastas ou grupos de arquivos nessa pasta.

public ref class StorageFolderQueryResult sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolderQueryResult final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolderQueryResult
Public NotInheritable Class StorageFolderQueryResult
Herança
Object Platform::Object IInspectable StorageFolderQueryResult
Atributos
Implementações

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo demonstra como obter pastas de lista (ou grupos de arquivos) de um objeto StorageFolderQueryResult.

// Get the Pictures library
Windows.Storage.StorageFolder picturesLibrary = Windows.Storage.KnownFolders.PicturesLibrary;

// Set query options to create groups of files within result
QueryOptions queryOptions = new QueryOptions(Windows.Storage.Search.CommonFolderQuery.GroupByMonth);

// Create query and retrieve result
StorageFolderQueryResult queryResult = picturesLibrary.CreateFolderQueryWithOptions(queryOptions);
IReadOnlyList<StorageFolder> folders = await queryResult.GetFoldersAsync();
// Process file groups
foreach (StorageFolder folder in folders)
{
    // Get and process files in group
    IReadOnlyList<StorageFile> fileList = await folder.GetFilesAsync();
    OutputPanel.Children.Add(CreateHeaderTextBlock(folder.Name + " (" + fileList.Count + ")"));
    foreach (StorageFile file in fileList)
    {
        // Process file
    }
}

A queryResult variável obtém o StorageFolderQueryResult usado para recuperar grupos de arquivos (ou pastas) que atendem aos critérios da consulta.

Observação

Você precisa da funcionalidade biblioteca Imagens para acessar a biblioteca usando KnownFolders.PicturesLibrary. Para saber mais sobre recursos e acesso a arquivos, confira Permissões de acesso a arquivos.

Comentários

Observação

Embora não seja atribuída com marshalling_behavior(agile), essa classe pode ser tratada como ágil. Para obter mais informações, consulte Threading e Marshaling (C++/CX).

Você pode obter um objeto StorageFolderQueryResult chamando os seguintes métodos de um objeto StorageFolder ou FolderInformation :

Para obter mais exemplos de código que mostram como usar objetos storageFolderQueryResult, consulte o exemplo de enumeração Folder.

Para obter um objeto StorageFolderQueryResult para enumerar as pastas ou grupos de arquivos em um local, você deve obter um storageFolder que represente o local e, em seguida, criar uma consulta de pasta.

Propriedades

Folder

Obtém a pasta usada originalmente para criar o objeto StorageFolderQueryResult . Essa pasta representa o escopo da consulta.

Métodos

ApplyNewQueryOptions(QueryOptions)

Modifica os resultados da consulta com base em novas QueryOptions.

FindStartIndexAsync(Object)

Recupera o índice da pasta dos resultados da consulta que correspondem mais de perto ao valor da propriedade especificada. A propriedade correspondente é determinada pela primeira SortEntry da lista QueryOptions.SortOrder .

GetCurrentQueryOptions()

Recupera as opções de consulta usadas para determinar os resultados da consulta.

GetFoldersAsync()

Recupera uma lista de todas as pastas (ou grupos de arquivos) no conjunto de resultados.

GetFoldersAsync(UInt32, UInt32)

Recupera pastas (ou grupos de arquivos) em um intervalo especificado.

GetItemCountAsync()

Recupera o número de pastas (ou grupos de arquivos) no conjunto de resultados da consulta.

Eventos

ContentsChanged

É acionado quando um arquivo é adicionado, excluído ou modificado na pasta que está sendo consultada. Esse evento só é acionado depois que GetFilesAsync é chamado pelo menos uma vez.

OptionsChanged

É acionado quando as opções de consulta são alteradas.

Aplica-se a

Confira também