StorageFolderQueryResult 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 den Ordner (oder die Dateigruppen) im abgefragten Ordner auflistet (der durch einen StorageFolder dargestellt wird). Sie können ein StorageFolderQueryResult verwenden, um Ordner oder Dateigruppen in diesem Ordner aufzulisten.

public ref class StorageFolderQueryResult sealed

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

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

Public NotInheritable Class StorageFolderQueryResult

Vererbung: Object Platform::Object IInspectable StorageFolderQueryResult

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 Listenordner (oder Dateigruppen) aus einem StorageFolderQueryResult-Objekt abgerufen werden.

// Get the Pictures library
Windows.Storage.StorageFolder picturesLibrary = Windows.Storage.KnownFolders.PicturesLibrary;

// Set query options to create groups of files within result
QueryOptions queryOptions = new QueryOptions(Windows.Storage.Search.CommonFolderQuery.GroupByMonth);

// Create query and retrieve result
StorageFolderQueryResult queryResult = picturesLibrary.CreateFolderQueryWithOptions(queryOptions);
IReadOnlyList<StorageFolder> folders = await queryResult.GetFoldersAsync();
// Process file groups
foreach (StorageFolder folder in folders)
{
    // Get and process files in group
    IReadOnlyList<StorageFile> fileList = await folder.GetFilesAsync();
    OutputPanel.Children.Add(CreateHeaderTextBlock(folder.Name + " (" + fileList.Count + ")"));
    foreach (StorageFile file in fileList)
    {
        // Process file
    }
}

Die queryResult Variable ruft das StorageFolderQueryResult ab, das zum Abrufen von Dateigruppen (oder Ordnern) verwendet wird, die die Kriterien der Abfrage erfüllen.

Hinweis

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

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 StorageFolderQueryResult-Objekt abrufen, indem Sie die folgenden Methoden aus einem StorageFolder- oder einem FolderInformation-Objekt aufrufen:

Weitere Codebeispiele zur Verwendung von storageFolderQueryResult-Objekten finden Sie im Folder-Enumerationsbeispiel.

Um ein StorageFolderQueryResult-Objekt abzurufen, um die Ordner oder Dateigruppen an einem Speicherort aufzulisten, müssen Sie einen storageFolder abrufen, der den Speicherort darstellt, und dann eine Ordnerabfrage erstellen.

Eigenschaften

Folder

Ruft den Ordner ab, der ursprünglich zum Erstellen des StorageFolderQueryResult-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 Ordners 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.
GetFoldersAsync()	Ruft eine Liste aller Ordner (oder Dateigruppen) im Resultset ab.
GetFoldersAsync(UInt32, UInt32)	Ruft Ordner (oder Dateigruppen) in einem angegebenen Bereich ab.
GetItemCountAsync()	Ruft die Anzahl der Ordner (oder Dateigruppen) in der Gruppe der Abfrageergebnisse ab.

Ereignisse

ContentsChanged	Wird ausgelöst, wenn eine Datei im abgefragten Ordner hinzugefügt, aus diesem 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