StorageFileQueryResult Klasse

Referenz

Definition

Namespace:: Windows.Storage.Search

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ermöglicht den Zugriff auf die Ergebnisse einer Abfrage der Dateien an dem Speicherort, der durch ein StorageFolder-Objekt dargestellt wird. Sie können StorageFileQueryResult verwenden, um die Dateien an diesem StorageFolder-Speicherort aufzulisten.

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

Vererbung: Object Platform::Object IInspectable StorageFileQueryResult

Attribute: ContractVersionAttribute

Implementiert: IStorageQueryResultBase

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird veranschaulicht, wie Sie eine Liste von Dateien aus einem StorageFileQueryResult-Objekt abrufen.

// 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
}

Die query Variable ruft das StorageFileQueryResult ab, das zum Abrufen von Dateien verwendet wird, die die Kriterien der Abfrage erfüllen.

Hinweis

Sie benötigen die Bibliotheksfunktion Bilder, um mit KnownFolders.PicturesLibrary auf die Bibliothek zuzugreifen. Weitere Informationen zu Funktionen und Dateizugriff finden Sie unter Dateizugriffsberechtigungen.

Hinweise

Hinweis

Obwohl sie nicht zugeordnet marshalling_behavior(agile)ist, kann diese Klasse als agil behandelt werden.

Sie können ein StorageFileQueryResult-Objekt abrufen, indem Sie die folgenden Methoden aus einem StorageFolder - oder folderInformation-Objekt aufrufen:

Eigenschaften

Folder

Ruft den Ordner ab, der zum Erstellen des StorageFileQueryResult-Objekts abgefragt wurde. Dieser Ordner stellt den Bereich der Abfrage dar.

Methoden

ApplyNewQueryOptions(QueryOptions)	Ändert Abfrageergebnisse basierend auf neuen QueryOptions.
FindStartIndexAsync(Object)	Ruft den Index der Datei aus den Abfrageergebnissen ab, die dem angegebenen Eigenschaftswert (oder der Datei, wenn mit FileActivatedEventArgs.NeighboringFilesQuery verwendet) am ehesten entspricht. Die übereinstimmenden Eigenschaften werden durch den ersten SortEntry der Liste QueryOptions.SortOrder bestimmt.
GetCurrentQueryOptions()	Ruft die Abfrageoptionen ab, die zum Bestimmen von Abfrageergebnissen verwendet werden.
GetFilesAsync()	Ruft eine Liste aller Dateien im Abfrageergebnissatz ab.
GetFilesAsync(UInt32, UInt32)	Ruft eine Liste von Dateien in einem angegebenen Bereich ab.
GetItemCountAsync()	Ruft die Anzahl der Dateien im Satz der Abfrageergebnisse ab.
GetMatchingPropertiesWithRanges(StorageFile)	Ruft übereinstimmende Dateieigenschaften mit entsprechenden Textbereichen ab.

Ereignisse

ContentsChanged	Wird ausgelöst, wenn eine Datei im abgefragten Ordner hinzugefügt, gelöscht oder geändert wird. Dieses Ereignis wird nur ausgelöst, nachdem GetFilesAsync mindestens einmal aufgerufen wurde.
OptionsChanged	Wird ausgelöst, wenn sich die Abfrageoptionen ändern.

Gilt für:

Freigeben über