StorageFolder.CreateFolderQuery Methode

  • Referenz

Definition

Namespace:
Windows.Storage

Überlädt

CreateFolderQuery()

Ruft ein Abfrageergebnisobjekt ab, das die Unterordner im aktuellen Ordner enthält.
CreateFolderQuery(CommonFolderQuery)

Ruft ein Abfrageergebnisobjekt ab, das die Unterordner im aktuellen Ordner enthält. Wenn der Wert des Abfragearguments etwas anderes als CommonFolderQuery.DefaultQuery ist, ruft eine Liste der virtuellen Ordner ab, die Container für Gruppen von Dateien in den Unterordnern des aktuellen Ordners darstellen. Dateien werden basierend auf dem angegebenen Wert aus der CommonFolderQuery-Enumeration in Ordnern gruppiert.

CreateFolderQuery()

Bearbeiten

Ruft ein Abfrageergebnisobjekt ab, das die Unterordner im aktuellen Ordner enthält.

public:
 virtual StorageFolderQueryResult ^ CreateFolderQuery() = CreateFolderQuery;
/// [Windows.Foundation.Metadata.Overload("CreateFolderQueryOverloadDefault")]
StorageFolderQueryResult CreateFolderQuery();
[Windows.Foundation.Metadata.Overload("CreateFolderQueryOverloadDefault")]
public StorageFolderQueryResult CreateFolderQuery();
function createFolderQuery()
Public Function CreateFolderQuery () As StorageFolderQueryResult

Gibt zurück

StorageFolderQueryResult

Ein Abfrageergebnisobjekt. Rufen Sie die GetFoldersAsync-Methode des Abfrageergebnisses auf, um die Unterordner im aktuellen Ordner abzurufen. Diese Methode gibt eine Liste vom Typ IReadOnlyList<StorageFolder> zurück. Jede Datei oder jeder Ordner wird durch ein Element vom Typ StorageFolder dargestellt.

Implementiert

CreateFolderQuery()
Attribute
OverloadAttribute

Ausnahmen

UnauthorizedAccessException

Sie sind nicht berechtigt, auf den Inhalt des aktuellen Ordners zuzugreifen.

Beispiele

Das folgende Beispiel zeigt, wie Sie den Inhalt der Unterordner im Ordner Pictures des Benutzers abrufen, gruppiert nach Monat, indem Sie die überladene GetFoldersAsync(CommonFolderQuery) -Methode aufrufen. (Dateien aus dem Stammverzeichnis des aktuellen Ordners sind nicht enthalten.)

Bevor Sie das folgende Beispiel ausführen, aktivieren Sie die Funktion Bilderbibliothek in der App-Manifestdatei.

using Windows.Storage;
using Windows.Storage.Search;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to the Output window.

// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;

// Get the files in the subfolders of the
// user's Pictures folder, grouped by month.
StorageFolderQueryResult groupedItems =
    picturesFolder.CreateFolderQuery(CommonFolderQuery.GroupByMonth);

// Iterate over the results and print the list of folders
// and files to the Visual Studio Output window.
foreach (StorageFolder folder in await groupedItems.GetFoldersAsync())
{
    Debug.WriteLine(folder.Name);

// To iterate over the files in each folder,
// uncomment the following lines.
// foreach(StorageFile file in await folder.GetFilesAsync())
//    Debug.WriteLine(" " + file.Name);
}

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the users's Pictures folder.
    // Enable the Pictures Library capability in the app manifest file.
    Windows::Storage::StorageFolder picturesFolder{ Windows::Storage::KnownFolders::PicturesLibrary() };

    // Get the files in the user's Pictures folder, and group them by month.
    Windows::Storage::Search::StorageFolderQueryResult results{ picturesFolder.CreateFolderQuery(Windows::Storage::Search::CommonFolderQuery::GroupByMonth) };

    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFolder> itemsInFolder{
        co_await results.GetFoldersAsync() };

    // Iterate over the results, and print the list of file groups to the Visual Studio output window.
    for (StorageFolder const& itemInFolder : itemsInFolder)
    {
        std::wstring output{ itemInFolder.Name() };
        ::OutputDebugString(output.c_str());
    }
}

// Get user's pictures folder
StorageFolder^ picturesFolder = KnownFolders::PicturesLibrary;

// Get the files in the user's Pictures folder and group them by month
StorageFolderQueryResult^ itemsInFolder = picturesFolder->CreateFolderQuery(CommonFolderQuery::GroupByMonth);

create_task(itemsInFolder->GetFoldersAsync()).then([=](IVectorView<StorageFolder^>^ itemsInFolder) {
 //Iterate over the results and print the list of file groups
 // to the visual studio output window
 for (auto it = itemsInFolder->First(); it->HasCurrent; it->MoveNext())
 {
  StorageFolder^ file = it->Current;
  String^ output = file->Name + "\n";
  OutputDebugString(output->Begin());
 }
});

Hinweise

Diese Abfrage ist eine flache Abfrage, die nur Unterordner im aktuellen Ordner zurückgibt. Eine Liste der Methoden, die flache Abfragen und tiefe Abfragen identifizieren, finden Sie in den Hinweisen in der GetFoldersAsync-Methode .

Rufen Sie die CreateFolderQueryWithOptions-Methode auf, um zusätzliche Abfrageoptionen anzugeben.

Um Elemente abzurufen, die Dateien oder Ordner sind, rufen Sie die CreateItemQuery-Methode auf.

Weitere Informationen

Gilt für:

CreateFolderQuery(CommonFolderQuery)

Bearbeiten

Ruft ein Abfrageergebnisobjekt ab, das die Unterordner im aktuellen Ordner enthält. Wenn der Wert des Abfragearguments etwas anderes als CommonFolderQuery.DefaultQuery ist, ruft eine Liste der virtuellen Ordner ab, die Container für Gruppen von Dateien in den Unterordnern des aktuellen Ordners darstellen. Dateien werden basierend auf dem angegebenen Wert aus der CommonFolderQuery-Enumeration in Ordnern gruppiert.

public:
 virtual StorageFolderQueryResult ^ CreateFolderQuery(CommonFolderQuery query) = CreateFolderQuery;
/// [Windows.Foundation.Metadata.Overload("CreateFolderQuery")]
StorageFolderQueryResult CreateFolderQuery(CommonFolderQuery const& query);
[Windows.Foundation.Metadata.Overload("CreateFolderQuery")]
public StorageFolderQueryResult CreateFolderQuery(CommonFolderQuery query);
function createFolderQuery(query)
Public Function CreateFolderQuery (query As CommonFolderQuery) As StorageFolderQueryResult

Parameter

query
CommonFolderQuery

Einer der Enumerationswerte, der angibt, wie die Dateien in Ordner gruppiert werden, und bestimmt, ob die Abfrage flach oder tief ist.

Gibt zurück

StorageFolderQueryResult

Ein Abfrageergebnisobjekt. Rufen Sie die GetFoldersAsync-Methode des Abfrageergebnisses auf, um die Unterordner im aktuellen Ordner abzurufen. Wenn der Wert des Abfragearguments etwas anderes als CommonFolderQuery.DefaultQuery ist, enthält das Abfrageergebnisobjekt eine Liste virtueller Ordner, die Container für Gruppen von Dateien in den Unterordnern des aktuellen Ordners darstellen. (Dateien aus dem aktuellen Ordner sind nicht enthalten.) Die Dateien werden gemäß abfragespezifischen Angaben gruppiert. Die Liste ist vom Typ IReadOnlyList<StorageFolder>. Jeder Ordner in der Liste wird durch ein StorageFolder-Objekt dargestellt.

Implementiert

CreateFolderQuery(CommonFolderQuery)
Attribute
OverloadAttribute

Ausnahmen

UnauthorizedAccessException

Sie sind nicht berechtigt, auf den Inhalt des aktuellen Ordners zuzugreifen.

ArgumentException

Sie haben einen anderen Wert als DefaultQuery aus der <xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery-Enumeration> für einen Ordner angegeben, der kein Bibliotheksordner ist. Überprüfen Sie den Wert der Abfrage.

Hinweise

Eine CommonFolderQuery gruppiert die Inhalte von Unterordnern schnell und einfach in Ordner, die auf bestimmten Dateiattributen (z. B. Künstler oder Album) basieren. Weitere Informationen zum Angeben von DefaultQuery-Optionen finden Sie in den Hinweisen auf der Seite CreateFileQuery-Methode.

Weitere Informationen

Gilt für: