StorageFolderQueryResult Clase

  • Referencia

Definición

Espacio de nombres:
Windows.Storage.Search
Editar

Proporciona acceso a los resultados de una consulta que enumera la carpeta (o los grupos de archivos) de la carpeta que se consulta (que se representa mediante storageFolder). Puede usar storageFolderQueryResult para enumerar carpetas o grupos de archivos de esa carpeta.

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
Herencia
Object Platform::Object IInspectable StorageFolderQueryResult
Atributos
ContractVersionAttribute
Implementaciones
IStorageQueryResultBase

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo se muestra cómo obtener una lista de carpetas (o grupos de archivos) de un 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
    }
}

La queryResult variable obtiene storageFolderQueryResult que se usa para recuperar grupos de archivos (o carpetas) que cumplen los criterios de la consulta.

Nota

Necesita la funcionalidad Biblioteca de imágenes para acceder a la biblioteca mediante KnownFolders.PicturesLibrary. Para más información sobre las funcionalidades y el acceso a archivos, consulte Permisos de acceso a archivos.

Comentarios

Nota

Aunque no se atribuye a marshalling_behavior(agile), esta clase se puede tratar como ágil. Para obtener más información, consulta Subprocesos y serialización (C++/CX).

Puede obtener un objeto StorageFolderQueryResult llamando a los métodos siguientes desde un objeto StorageFolder o FolderInformation :

Para obtener más ejemplos de código que muestran cómo usar objetos storageFolderQueryResult, consulte el ejemplo de enumeración Folder.

Para obtener un objeto StorageFolderQueryResult para enumerar las carpetas o grupos de archivos de una ubicación, debe obtener un storageFolder que represente la ubicación y, a continuación, crear una consulta de carpeta.

Propiedades

Folder

Obtiene la carpeta utilizada originalmente para crear el objeto StorageFolderQueryResult . Esta carpeta representa el ámbito de la consulta.

Métodos

ApplyNewQueryOptions(QueryOptions)

Modifica los resultados de la consulta en función de las nuevas QueryOptions.
FindStartIndexAsync(Object)

Recupera el índice de la carpeta de los resultados de la consulta que coincide con el valor de propiedad especificado. La propiedad que coincide viene determinada por el primer SortEntry de la lista QueryOptions.SortOrder .
GetCurrentQueryOptions()

Recupera las opciones de consulta usadas para determinar los resultados de la consulta.
GetFoldersAsync()

Recupera una lista de todas las carpetas (o grupos de archivos) del conjunto de resultados.
GetFoldersAsync(UInt32, UInt32)

Recupera carpetas (o grupos de archivos) en un intervalo especificado.
GetItemCountAsync()

Recupera el número de carpetas (o grupos de archivos) en el conjunto de resultados de la consulta.

Eventos

ContentsChanged

Se desencadena cuando se agrega, elimina o modifica un archivo en la carpeta que se consulta. Este evento solo se desencadena después de llamar a GetFilesAsync al menos una vez.
OptionsChanged

Se activa cuando cambian las opciones de consulta.

Se aplica a

Consulte también