Freigeben über


StorageFolder.GetFoldersAsync Methode

Definition

Überlädt

GetFoldersAsync()

Ruft die Unterordner im aktuellen Ordner ab.

GetFoldersAsync(CommonFolderQuery)

Ruft die Unterordner im aktuellen Ordner ab. 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.

GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

Ruft einen indexbasierten Ordnerbereich aus der Liste aller Unterordner im aktuellen Ordner ab. 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.

GetFoldersAsync()

Ruft die Unterordner im aktuellen Ordner ab.

public:
 virtual IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync() = GetFoldersAsync;
/// [Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultOptionsStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync();
[Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultOptionsStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync();
function getFoldersAsync()
Public Function GetFoldersAsync () As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird eine Liste der Unterordner im aktuellen Ordner zurückgegeben. 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. Weitere Informationen finden Sie unter Dateizugriffsberechtigungen.

Beispiele

Das folgende Beispiel zeigt, wie Sie den Inhalt der Unterordner im Ordner Pictures des Benutzers, gruppiert nach Monat, abrufen, indem Sie die GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)- Methode aufrufen. (Dateien aus dem Stammverzeichnis des aktuellen Ordners sind nicht enthalten.) In diesem Beispiel werden maximal 4 Ordner zurückgegeben, beginnend mit dem Ordner bei Index 0. Da die Option CommonFolderQuery.GroupByMonth Datumsangaben in absteigender Reihenfolge sortiert (d. h. vom neuesten zum ältesten), gibt dieses Beispiel Ordner für die letzten vier Monate zurück, für die der Benutzer Fotos hat. Jeder Ordner enthält alle Fotos des Benutzers aus diesem Monat.

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 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. Get only the first 4 folders (months).
IReadOnlyList <StorageFolder> groupedItems = await picturesFolder.GetFoldersAsync(CommonFolderQuery.GroupByMonth, 0, 4);

// Iterate over the results and print the list of folders
// and files to the Visual Studio Output window.
foreach (StorageFolder folder in groupedItems)
{
    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, grouped by month.
    // Get only the first 4 folders (months).
    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFolder> itemsInFolder{
        co_await picturesFolder.GetFoldersAsync(Windows::Storage::Search::CommonFolderQuery::GroupByMonth, 0, 4) };

    // 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 the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder^ picturesFolder = KnownFolders::PicturesLibrary;

// Get the files in the user's Pictures folder, grouped by month.
// Get only the first 4 folders (months).
create_task(picturesFolder->GetFoldersAsync(CommonFolderQuery::GroupByMonth, 0, 4)).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.

In der folgenden Tabelle sind Methoden der StorageFolder-Klasse aufgeführt, die eine Liste von Unterordnern abrufen. Die Tabelle identifiziert flache Abfragen, die nur Unterordner aus dem aktuellen Ordner zurückgeben, und tiefe Abfragen, die den Inhalt geschachtelter Unterordner zurückgeben, die in virtuellen Ordnern gruppiert sind.

Einige Methoden verwenden einen Wert aus der CommonFolderQuery-Enumeration .

  • Wenn Sie die DefaultQuery-Option mit einem beliebigen Ordner verwenden, gibt die Abfrage eine Liste von Unterordnern im Dateisystem zurück.
  • Wenn Sie eine andere Option als DefaultQuery mit einem Bibliotheksordner verwenden, gibt die Abfrage eine Liste virtueller Ordner zurück, die Container für Dateien aus den Unterordnern des aktuellen Ordners darstellen. (Dateien aus dem aktuellen Ordner sind nicht enthalten.) Die Dateien werden basierend auf dem angegebenen Wert aus der CommonFolderQuery-Enumeration in virtuelle Ordner gruppiert. Wenn Sie beispielsweise GroupByMonth angeben, gibt die Abfrage eine Liste von virtuellen Ordnern wie July 2014, August 2014und September 2014zurück.

Tipp

Sie können die DefaultQuery-Option mit jedem Beliebigen Ordner verwenden. Sie können die anderen Optionen aus der CommonFolderQuery-Enumeration nur mit Bibliotheksordnern wie der Bildbibliothek oder dem Ordner Heimnetzgruppe verwenden.

Um tiefe Abfrageergebnisse aus einem Ordner zu erhalten, der kein Bibliotheksordner ist, rufen Sie die CreateFolderQueryWithOptions(QueryOptions) -Methode auf, und geben Sie Deep als Wert der FolderDepth-Eigenschaft des QueryOptions-Objekts an.

Methode Erstellen einer flachen Abfrage, die nur Unterordner aus dem aktuellen Ordner zurückgibt Erstellen einer tiefen Abfrage, die alle geschachtelten Unterordner zurückgibt
GetFoldersAsync() Standardverhalten dieser Methode.
GetFoldersAsync(CommonFileQuery) Geben Sie die Option DefaultQuery an. Geben Sie für einen Bibliotheksordner eine andere Option als DefaultQuery an.
GetFoldersAsync(CommonFileQuery, UInt32, UInt32) Geben Sie die Option DefaultQuery an. Geben Sie für einen Bibliotheksordner eine andere Option als DefaultQuery an.
CreateFolderQuery() Standardverhalten dieser Methode.
CreateFolderQuery(CommonFileQuery) Geben Sie die Option DefaultQuery an. Geben Sie für einen Bibliotheksordner eine andere Option als DefaultQuery an.
CreateFolderQueryWithOptions(QueryOptions) Standardverhalten dieser Methode, wenn keine der folgenden Optionen angegeben ist.
- oder -
Geben Sie DefaultQuery als Wert von CommonFolderQuery an, wenn Sie das QueryOptions-Objekt instanziieren .
- oder -
Geben Sie Shallow als Wert der FolderDepth-Eigenschaft des QueryOptions-Objekts an.
Geben Sie für einen Bibliotheksordner einen anderen Wert als DefaultQuery als Den Wert von CommonFolderQuery an, wenn Sie das QueryOptions-Objekt instanziieren .
- oder -
Geben Sie für jeden Ordner Deep als Wert der FolderDepth-Eigenschaft der QueryOptions-Eigenschaft an.

Weitere Informationen

Gilt für:

GetFoldersAsync(CommonFolderQuery)

Ruft die Unterordner im aktuellen Ordner ab. 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 IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync(CommonFolderQuery query) = GetFoldersAsync;
/// [Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync(CommonFolderQuery const& query);
[Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query);
function getFoldersAsync(query)
Public Function GetFoldersAsync (query As CommonFolderQuery) As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))

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

Wenn diese Methode erfolgreich abgeschlossen wurde, wird eine Liste von Unterordnern zurückgegeben. Wenn der Wert des Abfragearguments etwas anderes als CommonFolderQuery.DefaultQuery ist, gibt diese Methode eine Liste virtueller Ordner zurück, 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. Weitere Informationen finden Sie unter Dateizugriffsberechtigungen.

Weitere Informationen

Gilt für:

GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

Ruft einen indexbasierten Ordnerbereich aus der Liste aller Unterordner im aktuellen Ordner ab. 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 IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync(CommonFolderQuery query, unsigned int startIndex, unsigned int maxItemsToRetrieve) = GetFoldersAsync;
/// [Windows.Foundation.Metadata.Overload("GetFoldersAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync(CommonFolderQuery const& query, uint32_t const& startIndex, uint32_t const& maxItemsToRetrieve);
[Windows.Foundation.Metadata.Overload("GetFoldersAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query, uint startIndex, uint maxItemsToRetrieve);
function getFoldersAsync(query, startIndex, maxItemsToRetrieve)
Public Function GetFoldersAsync (query As CommonFolderQuery, startIndex As UInteger, maxItemsToRetrieve As UInteger) As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))

Parameter

query
CommonFolderQuery

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

startIndex
UInt32

unsigned int

uint32_t

Der nullbasierte Index des ersten Ordners im abzurufenden Bereich.

maxItemsToRetrieve
UInt32

unsigned int

uint32_t

Die maximale Anzahl der abzurufenden Ordner.

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird eine Liste von Unterordnern zurückgegeben. Wenn der Wert des Abfragearguments etwas anderes als CommonFolderQuery.DefaultQuery ist, gibt diese Methode eine Liste virtueller Ordner zurück, 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

M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFoldersAsync(Windows.Storage.Search.CommonFolderQuery,System.UInt32,System.UInt32) M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFoldersAsync(Windows.Storage.Search.CommonFolderQuery,unsigned int,unsigned int) M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFoldersAsync(Windows.Storage.Search.CommonFolderQuery,uint32_t,uint32_t)
Attribute

Ausnahmen

Sie sind nicht berechtigt, auf den Inhalt des aktuellen Ordners zuzugreifen. Weitere Informationen finden Sie unter Dateizugriffsberechtigungen.

Weitere Informationen

Gilt für: