StorageFolder.CreateFolderQuery Método

  • Referencia

Definición

Espacio de nombres:
Windows.Storage

Sobrecargas

CreateFolderQuery()

Obtiene un objeto de resultado de consulta que contiene las subcarpetas de la carpeta actual.
CreateFolderQuery(CommonFolderQuery)

Obtiene un objeto de resultado de consulta que contiene las subcarpetas de la carpeta actual. Cuando el valor del argumento de consulta es distinto de CommonFolderQuery.DefaultQuery, obtiene una lista de carpetas virtuales que representan contenedores para grupos de archivos en las subcarpetas de la carpeta actual. Los archivos se agrupan en carpetas según el valor especificado de la enumeración CommonFolderQuery .

CreateFolderQuery()

Editar

Obtiene un objeto de resultado de consulta que contiene las subcarpetas de la carpeta actual.

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

Devoluciones

StorageFolderQueryResult

Objeto de resultado de la consulta. Llame al método GetFoldersAsync del resultado de la consulta para obtener las subcarpetas de la carpeta actual. Este método devuelve una lista de tipo IReadOnlyList<StorageFolder>. Cada archivo o carpeta se representa mediante un elemento de tipo StorageFolder.

Implementaciones

CreateFolderQuery()
Atributos
OverloadAttribute

Excepciones

UnauthorizedAccessException

No tiene permiso para acceder al contenido de la carpeta actual.

Ejemplos

En el ejemplo siguiente se muestra cómo obtener el contenido de las subcarpetas de la carpeta Imágenes del usuario, agrupadas en carpetas por mes, llamando al método sobrecargado GetFoldersAsync(CommonFolderQuery). (No se incluyen los archivos de la raíz de la carpeta actual).

Antes de ejecutar el ejemplo siguiente, habilite la funcionalidad Biblioteca de imágenes en el archivo de manifiesto de la aplicación.

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

Comentarios

Esta consulta es una consulta superficial que devuelve solo subcarpetas en la carpeta actual. Para obtener una lista de métodos que identifican consultas poco profundas y consultas profundas, vea los comentarios en el método GetFoldersAsync .

Para especificar opciones de consulta adicionales, llame al método CreateFolderQueryWithOptions .

Para obtener elementos que son archivos o carpetas, llame al método CreateItemQuery .

Consulte también

Se aplica a

CreateFolderQuery(CommonFolderQuery)

Editar

Obtiene un objeto de resultado de consulta que contiene las subcarpetas de la carpeta actual. Cuando el valor del argumento de consulta es distinto de CommonFolderQuery.DefaultQuery, obtiene una lista de carpetas virtuales que representan contenedores para grupos de archivos en las subcarpetas de la carpeta actual. Los archivos se agrupan en carpetas según el valor especificado de la enumeración 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

Parámetros

query
CommonFolderQuery

Uno de los valores de enumeración que especifica cómo agrupar los archivos en carpetas y determina si la consulta es superficial o profunda.

Devoluciones

StorageFolderQueryResult

Objeto de resultado de la consulta. Llame al método GetFoldersAsync del resultado de la consulta para obtener las subcarpetas de la carpeta actual. Cuando el valor del argumento de consulta es algo distinto de CommonFolderQuery.DefaultQuery, el objeto de resultado de la consulta contiene una lista de carpetas virtuales que representan contenedores para grupos de archivos en las subcarpetas de la carpeta actual. (No se incluyen los archivos de la carpeta actual). Los archivos se agrupan según lo especificado por la consulta. La lista es de tipo IReadOnlyList<StorageFolder>. Cada carpeta de la lista se representa mediante un objeto StorageFolder .

Implementaciones

CreateFolderQuery(CommonFolderQuery)
Atributos
OverloadAttribute

Excepciones

UnauthorizedAccessException

No tiene permiso para acceder al contenido de la carpeta actual.

ArgumentException

Especificó un valor distinto de DefaultQuery de la <enumeración xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery> para una carpeta que no es una carpeta de biblioteca. Compruebe el valor de la consulta.

Comentarios

CommonFolderQuery agrupa el contenido de las subcarpetas en carpetas basadas en atributos de archivo específicos (como artista o álbum) de forma rápida y sencilla. Consulte los comentarios de la página del método CreateFileQuery para obtener más información sobre cómo especificar las opciones defaultQuery .

Consulte también

Se aplica a