StorageItemQueryResult Klasse
Definition
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.
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 StorageItemQueryResultPublic NotInheritable Class StorageItemQueryResult- Vererbung
- Attribute
- Implementiert
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. |