StorageFolder.CreateFolderQuery Methode
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.
Ü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()
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
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
- Attribute
Ausnahmen
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)
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
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
- Attribute
Ausnahmen
Sie sind nicht berechtigt, auf den Inhalt des aktuellen Ordners zuzugreifen.
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.