Compartir a través de


StorageFileQueryResult Clase

Definición

Proporciona acceso a los resultados de una consulta de los archivos en la ubicación representada por un objeto StorageFolder . Puede usar StorageFileQueryResult para enumerar los archivos de esa ubicación 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
Herencia
Object Platform::Object IInspectable StorageFileQueryResult
Atributos
Implementaciones

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 archivos de un 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
}

La query variable obtiene el StorageFileQueryResult que se usa para recuperar archivos 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.

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

Propiedades

Folder

Obtiene la carpeta que se ha consultado para crear el objeto StorageFileQueryResult . 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 del archivo de los resultados de la consulta que coincide más estrechamente con el valor de propiedad especificado (o archivo, si se usa con FileActivatedEventArgs.NeighboringFilesQuery). 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.

GetFilesAsync()

Recupera una lista de todos los archivos del conjunto de resultados de la consulta.

GetFilesAsync(UInt32, UInt32)

Recupera una lista de archivos en un intervalo especificado.

GetItemCountAsync()

Recupera el número de archivos del conjunto de resultados de la consulta.

GetMatchingPropertiesWithRanges(StorageFile)

Obtiene las propiedades de archivo coincidentes con los intervalos de texto correspondientes.

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