StorageFileQueryResult Klasse

  • Referenz

Definition

Namespace:
Windows.Storage.Search
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:

Weitere Informationen