Share via

StorageFileQueryResult Classe

  • Referência

Definição

Namespace:
Windows.Storage.Search
Editar

Fornece acesso aos resultados de uma consulta dos arquivos no local representado por um objeto StorageFolder . Você pode usar StorageFileQueryResult para enumerar os arquivos nesse local StorageFolder .

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

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 uma lista de arquivos de um objeto StorageFileQueryResult.

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Process file
}

A query variável obtém o StorageFileQueryResult usado para recuperar arquivos 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.

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

Propriedades

Folder

Obtém a pasta que foi consultada para criar o objeto StorageFileQueryResult . 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 do arquivo dos resultados da consulta que mais correspondem ao valor da propriedade especificado (ou arquivo, se usado com FileActivatedEventArgs.NeighboringFilesQuery). 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.
GetFilesAsync()

Recupera uma lista de todos os arquivos no conjunto de resultados da consulta.
GetFilesAsync(UInt32, UInt32)

Recupera uma lista de arquivos em um intervalo especificado.
GetItemCountAsync()

Recupera o número de arquivos no conjunto de resultados da consulta.
GetMatchingPropertiesWithRanges(StorageFile)

Obtém propriedades de arquivo correspondentes com intervalos de texto correspondentes.

Eventos

ContentsChanged

Aciona 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

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

Aplica-se a

Confira também