StorageFolder.CreateFolderQuery Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Overload

CreateFolderQuery()

Ottiene un oggetto risultato della query contenente le sottocartelle nella cartella corrente.

CreateFolderQuery(CommonFolderQuery)

Ottiene un oggetto risultato della query contenente le sottocartelle nella cartella corrente. Quando il valore dell'argomento di query è diverso da CommonFolderQuery.DefaultQuery, ottiene un elenco di cartelle virtuali che rappresentano contenitori per i gruppi di file nelle sottocartelle della cartella corrente. I file vengono raggruppati in cartelle in base al valore specificato dall'enumerazione CommonFolderQuery .

CreateFolderQuery()

Ottiene un oggetto risultato della query contenente le sottocartelle nella cartella corrente.

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

Restituisce

StorageFolderQueryResult

Oggetto risultato della query. Chiamare il metodo GetFoldersAsync del risultato della query per ottenere le sottocartelle nella cartella corrente. Questo metodo restituisce un elenco di tipo IReadOnlyList<StorageFolder>. Ogni file o cartella è rappresentato da un elemento di tipo StorageFolder.

Implementazioni

CreateFolderQuery()

Attributi

OverloadAttribute

Eccezioni

UnauthorizedAccessException

Non si dispone dell'autorizzazione per accedere al contenuto della cartella corrente.

Esempio

Nell'esempio seguente viene illustrato come ottenere il contenuto delle sottocartelle nella cartella Pictures dell'utente, raggruppata in cartelle per mese, chiamando il metodo di overload GetFoldersAsync(CommonFolderQuery). I file dalla radice della cartella corrente non sono inclusi.

Prima di eseguire l'esempio seguente, abilitare la funzionalità Raccolta immagini nel file manifesto dell'app.

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

Commenti

Questa query è una query superficiale che restituisce solo sottocartelle nella cartella corrente. Per un elenco di metodi che identificano query superficiali e query profonde, vedere la sezione Osservazioni nel metodo GetFoldersAsync .

Per specificare opzioni di query aggiuntive, chiamare il metodo CreateFolderQueryWithOptions .

Per ottenere elementi che sono file o cartelle, chiamare il metodo CreateItemQuery .

Vedi anche

• CreateFolderQuery(CommonFolderQuery)

CreateFolderQuery(CommonFolderQuery)

Ottiene un oggetto risultato della query contenente le sottocartelle nella cartella corrente. Quando il valore dell'argomento di query è diverso da CommonFolderQuery.DefaultQuery, ottiene un elenco di cartelle virtuali che rappresentano contenitori per i gruppi di file nelle sottocartelle della cartella corrente. I file vengono raggruppati in cartelle in base al valore specificato dall'enumerazione 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

Parametri

query

CommonFolderQuery

Uno dei valori di enumerazione che specifica come raggruppare i file in cartelle e determina se la query è superficiale o profonda.

Restituisce

StorageFolderQueryResult

Oggetto risultato della query. Chiamare il metodo GetFoldersAsync del risultato della query per ottenere le sottocartelle nella cartella corrente. Quando il valore dell'argomento di query è diverso da CommonFolderQuery.DefaultQuery, l'oggetto risultato della query contiene un elenco di cartelle virtuali che rappresentano contenitori per i gruppi di file nelle sottocartelle della cartella corrente. I file della cartella corrente non sono inclusi. I file vengono raggruppati come specificato dalla query. L'elenco è di tipo IReadOnlyList<StorageFolder>. Ogni cartella nell'elenco è rappresentata da un oggetto StorageFolder .

Implementazioni

CreateFolderQuery(CommonFolderQuery)

Attributi

OverloadAttribute

Eccezioni

UnauthorizedAccessException

Non si dispone dell'autorizzazione per accedere al contenuto della cartella corrente.

ArgumentException

È stato specificato un valore diverso da DefaultQuery dall'enumerazione <xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery> per una cartella che non è una cartella di libreria. Controllare il valore della query.

Commenti

CommonFolderQuery raggruppa il contenuto delle sottocartelle in cartelle in base a attributi di file specifici (come artista o album) in modo rapido e semplice. Per altre informazioni sulla specifica delle opzioni DefaultQuery, vedere la pagina Osservazioni nella pagina del metodo CreateFileQuery.

Vedi anche

• CreateFolderQuery()