StorageItemQueryResult 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

Bietet Zugriff auf die Ergebnisse einer Abfrage, die alle Elemente auflistet, einschließlich Dateien und Ordnern (oder Dateigruppen) in dem ordner, der abgefragt wird (der durch einen StorageFolder dargestellt wird). Sie können storageItemQueryResult verwenden, um die Dateien und Ordner in diesem StorageFolder aufzulisten.

public ref class StorageItemQueryResult sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemQueryResult final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemQueryResult

Public NotInheritable Class StorageItemQueryResult

Vererbung: Object Platform::Object IInspectable StorageItemQueryResult

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)

Hinweise

Hinweis

Obwohl sie nicht mit marshalling_behavior(agile)zugeschrieben wird, kann diese Klasse als agil behandelt werden. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX).

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

StorageFolder.CreateItemQuery-Methoden
StorageFolder.CreateItemQueryWithOptions-Methode
FolderInformation.CreateItemQuery-Methoden
FolderInformation.CreateItemQueryWithOptions-Methode Verwandte Codebeispiele finden Sie unter storageFileQueryResult, storageFolderQueryResult, das Folder-Enumerationsbeispiel und das Beispiel für die Dateisuche.

Eigenschaften

Folder

Ruft den Ordner ab, der ursprünglich zum Erstellen des StorageItemQueryResult-Objekts verwendet wurde. Dieser Ordner stellt den Bereich der Abfrage dar.

Methoden

ApplyNewQueryOptions(QueryOptions)	Ändert Abfrageergebnisse basierend auf neuen QueryOptions.
FindStartIndexAsync(Object)	Ruft den Index des Elements aus den Abfrageergebnissen ab, die dem angegebenen Eigenschaftswert am ehesten entsprechen. 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.
GetItemCountAsync()	Ruft die Anzahl der Elemente im Satz von Abfrageergebnissen ab.
GetItemsAsync()	Ruft eine Liste aller Elemente (Dateien und Ordner) im Abfrageergebnissatz ab.
GetItemsAsync(UInt32, UInt32)	Ruft eine Liste von Elementen (Dateien und Ordnern) in einem angegebenen Bereich ab.

Ereignisse

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

Gilt für: