StorageFolder.CreateFileQuery Método

Definición

Espacio de nombres:

Windows.Storage

Sobrecargas

CreateFileQuery()	Obtiene un objeto de resultado de consulta que contiene los archivos de la carpeta actual.
CreateFileQuery(CommonFileQuery)	Obtiene un objeto de resultado de consulta que contiene los archivos de la carpeta actual. Obtiene también los archivos de las subcarpetas de la carpeta actual cuando el valor del argumento de consulta es algo distinto de CommonFileQuery.DefaultQuery. Los archivos se ordenan en función de CommonFileQuery especificado.

CreateFileQuery()

Obtiene un objeto de resultado de consulta que contiene los archivos de la carpeta actual.

public:
 virtual StorageFileQueryResult ^ CreateFileQuery() = CreateFileQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFileQueryOverloadDefault")]
StorageFileQueryResult CreateFileQuery();

[Windows.Foundation.Metadata.Overload("CreateFileQueryOverloadDefault")]
public StorageFileQueryResult CreateFileQuery();

function createFileQuery()

Public Function CreateFileQuery () As StorageFileQueryResult

Devoluciones

StorageFileQueryResult

Objeto de resultado de consulta. Llame al método GetFilesAsync del resultado de la consulta para obtener la lista plana de archivos. Este método devuelve una lista de tipo IReadOnlyList<StorageFile>. Cada archivo se representa mediante un elemento de tipo StorageFile.

Implementaciones

CreateFileQuery()

Atributos

OverloadAttribute

Ejemplos

En el ejemplo siguiente se obtiene un objeto de resultado de consulta que contiene los archivos de la carpeta actual llamando al método CreateFileQuery().

using Windows.Storage;
using Windows.Storage.Search;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to Output window.

// Get the app's installation folder.
StorageFolder appFolder = Windows.ApplicationModel.Package.Current.InstalledLocation;

// Get the files in the current folder.
StorageFileQueryResult results = appFolder.CreateFileQuery();

// Iterate over the results and print the list of files
// to the Visual Studio Output window.
IReadOnlyList<StorageFile> filesInFolder = await results.GetFilesAsync();
foreach (StorageFile item in filesInFolder)
{
    Debug.WriteLine(item.Name);
}

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the app's installation folder.
    Windows::Storage::StorageFolder appFolder{ Windows::ApplicationModel::Package::Current().InstalledLocation() };
    // Get the files in the current folder.
    Windows::Storage::Search::StorageFileQueryResult results{ appFolder.CreateFileQuery() };

    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFile> filesInFolder{
        co_await results.GetFilesAsync() };

    // Iterate over the results, and print the list of files to the Visual Studio output window.
    for (StorageFile const& fileInFolder : filesInFolder)
    {
        std::wstring output{ fileInFolder.Name() };
        ::OutputDebugString(output.c_str());
    }
}

//Get the app's installation folder
StorageFolder^ appFolder = Windows::ApplicationModel::Package::Current->InstalledLocation;
//Get the files in the current folder
StorageFileQueryResult^ results = appFolder->CreateFileQuery();

create_task(results->GetFilesAsync()).then([=](IVectorView<StorageFile^>^ filesInFolder) {
 //Iterate over the results and print the list of files
 // to the visual studio output window
 for (auto it = filesInFolder->First(); it->HasCurrent; it->MoveNext())
 {
  StorageFile^ file = it->Current;
  String^ output = file->Name + "\n";
  OutputDebugString(output->Begin());
 }
});

Comentarios

Esta consulta es una consulta superficial que devuelve solo los archivos de la carpeta actual. Para obtener una lista de métodos que identifican consultas poco profundas y consultas profundas, vea los comentarios del tema GetFilesAsync.

También puede obtener una lista de archivos en la carpeta actual de forma asincrónica llamando a uno de los métodos GetFilesAsync .

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

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

Consulte también

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions(QueryOptions)

CreateFileQuery(CommonFileQuery)

Obtiene un objeto de resultado de consulta que contiene los archivos de la carpeta actual. Obtiene también los archivos de las subcarpetas de la carpeta actual cuando el valor del argumento de consulta es algo distinto de CommonFileQuery.DefaultQuery. Los archivos se ordenan en función de CommonFileQuery especificado.

public:
 virtual StorageFileQueryResult ^ CreateFileQuery(CommonFileQuery query) = CreateFileQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFileQuery")]
StorageFileQueryResult CreateFileQuery(CommonFileQuery const& query);

[Windows.Foundation.Metadata.Overload("CreateFileQuery")]
public StorageFileQueryResult CreateFileQuery(CommonFileQuery query);

function createFileQuery(query)

Public Function CreateFileQuery (query As CommonFileQuery) As StorageFileQueryResult

Parámetros

query

CommonFileQuery

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

Devoluciones

StorageFileQueryResult

Objeto de resultado de consulta. Llame al método GetFilesAsync del resultado de la consulta para obtener la lista plana de archivos, ordenado según lo especificado por la consulta. Este método devuelve una lista de tipo IReadOnlyList<StorageFile>. Cada archivo se representa mediante un elemento de tipo StorageFile.

Implementaciones

CreateFileQuery(CommonFileQuery)

Atributos

OverloadAttribute

Excepciones

ArgumentException

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

Comentarios

CommonFileQuery ordena archivos basados en atributos de archivo específicos (como título o fecha) de forma rápida y sencilla.

Cuando se especifica la opción DefaultQuery de la enumeración CommonFileQuery , esta consulta es una consulta superficial que devuelve solo los archivos de la carpeta actual. Al especificar otro valor de la enumeración CommonFileQuery , esta consulta es una consulta profunda que devuelve una lista plana de archivos de la carpeta actual y de sus subcarpetas.

Sugerencia

Algunos de los valores de la enumeración CommonFileQuery solo se pueden usar con una carpeta de biblioteca (como la biblioteca imágenes) o la carpeta Grupo hogar. Además de la opción DefaultQuery , solo puede usar las opciones OrderByName y OrderBySearchRank con una carpeta que no sea una carpeta de biblioteca.

Para obtener una lista de métodos que identifican consultas poco profundas y consultas profundas, vea los comentarios del tema GetFilesAsync.

Para comprobar si hay disponible una commonFileQuery específica, llame al método IsCommonFileQuerySupported de la carpeta.

También puede obtener una lista de archivos en la carpeta actual de forma asincrónica llamando a uno de los métodos GetFilesAsync .

Para Windows Server 2012 Debe instalar componentes del indexador para usar algunos valores de CommonFileQuery porque los componentes del indexador no están instalados de forma predeterminada.

Consulte también

• CreateFileQuery()
• CreateFileQueryWithOptions(QueryOptions)