StorageFolder.CreateFolderQuery Méthode

Définition

Espace de noms:

Windows.Storage

Surcharges

CreateFolderQuery()

Obtient un objet de résultat de requête qui contient les sous-dossiers du dossier actif.

CreateFolderQuery(CommonFolderQuery)

Obtient un objet de résultat de requête qui contient les sous-dossiers du dossier actif. Lorsque la valeur de l’argument de requête est autre que CommonFolderQuery.DefaultQuery, obtient une liste de dossiers virtuels qui représentent des conteneurs pour les groupes de fichiers dans les sous-dossiers du dossier actif. Les fichiers sont regroupés dans des dossiers en fonction de la valeur spécifiée de l’énumération CommonFolderQuery .

CreateFolderQuery()

Obtient un objet de résultat de requête qui contient les sous-dossiers du dossier actif.

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

Retours

StorageFolderQueryResult

Objet de résultat de requête. Appelez la méthode GetFoldersAsync du résultat de la requête pour obtenir les sous-dossiers dans le dossier actif. Cette méthode retourne une liste de type IReadOnlyList<StorageFolder>. Chaque fichier ou dossier est représenté par un élément de type StorageFolder.

Implémente

CreateFolderQuery()

Attributs

OverloadAttribute

Exceptions

UnauthorizedAccessException

Vous n’êtes pas autorisé à accéder au contenu du dossier actif.

Exemples

L’exemple suivant montre comment obtenir le contenu des sous-dossiers dans le dossier Images de l’utilisateur, regroupés en dossiers par mois, en appelant la méthode surchargée GetFoldersAsync(CommonFolderQuery). (Les fichiers de la racine du dossier actif ne sont pas inclus.)

Avant d’exécuter l’exemple suivant, activez la fonctionnalité Bibliothèque d’images dans le fichier manifeste de l’application.

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());
 }
});

Remarques

Cette requête est une requête superficielle qui retourne uniquement des sous-dossiers dans le dossier actif. Pour obtenir la liste des méthodes qui identifient les requêtes superficielles et les requêtes approfondies, consultez les remarques dans la méthode GetFoldersAsync .

Pour spécifier des options de requête supplémentaires, appelez la méthode CreateFolderQueryWithOptions .

Pour obtenir des éléments qui sont des fichiers ou des dossiers, appelez la méthode CreateItemQuery .

Voir aussi

• CreateFolderQuery(CommonFolderQuery)

CreateFolderQuery(CommonFolderQuery)

Obtient un objet de résultat de requête qui contient les sous-dossiers du dossier actif. Lorsque la valeur de l’argument de requête est autre que CommonFolderQuery.DefaultQuery, obtient une liste de dossiers virtuels qui représentent des conteneurs pour les groupes de fichiers dans les sous-dossiers du dossier actif. Les fichiers sont regroupés dans des dossiers en fonction de la valeur spécifiée de l’énumération CommonFolderQuery .

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

Paramètres

query

CommonFolderQuery

Une des valeurs d’énumération qui spécifie comment regrouper les fichiers dans des dossiers et détermine si la requête est superficielle ou profonde.

Retours

StorageFolderQueryResult

Objet de résultat de requête. Appelez la méthode GetFoldersAsync du résultat de la requête pour obtenir les sous-dossiers dans le dossier actif. Lorsque la valeur de l’argument de requête est autre que CommonFolderQuery.DefaultQuery, l’objet de résultat de la requête contient une liste de dossiers virtuels qui représentent des conteneurs pour les groupes de fichiers dans les sous-dossiers du dossier actif. (Les fichiers du dossier actif ne sont pas inclus.) Les fichiers sont regroupés comme spécifié par requête. La liste est de type IReadOnlyList<StorageFolder>. Chaque dossier de la liste est représenté par un objet StorageFolder .

Implémente

CreateFolderQuery(CommonFolderQuery)

Attributs

OverloadAttribute

Exceptions

UnauthorizedAccessException

Vous n’êtes pas autorisé à accéder au contenu du dossier actif.

ArgumentException

Vous avez spécifié une valeur autre que DefaultQuery à partir de l’énumération <xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery> pour un dossier qui n’est pas un dossier de bibliothèque. Vérifiez la valeur de la requête.

Remarques

Un CommonFolderQuery regroupe rapidement et facilement le contenu des sous-dossiers dans des dossiers en fonction d’attributs de fichier spécifiques (comme l’artiste ou l’album). Consultez la page Remarques sur la méthode CreateFileQuery pour plus d’informations sur la spécification des options DefaultQuery .

Voir aussi

• CreateFolderQuery()