StorageFolder.CreateFileQuery Método

Definição

Namespace:

Windows.Storage

Sobrecargas

CreateFileQuery()	Obtém um objeto de resultado de consulta que contém os arquivos na pasta atual.
CreateFileQuery(CommonFileQuery)	Obtém um objeto de resultado de consulta que contém os arquivos na pasta atual. Também obtém os arquivos das subpastas da pasta atual quando o valor do argumento de consulta é algo diferente de CommonFileQuery.DefaultQuery. Os arquivos são classificados com base no CommonFileQuery especificado.

CreateFileQuery()

Obtém um objeto de resultado de consulta que contém os arquivos na pasta atual.

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

Retornos

StorageFileQueryResult

Um objeto de resultado da consulta. Chame o método GetFilesAsync do resultado da consulta para obter a lista simples de arquivos. Esse método retorna uma lista do tipo IReadOnlyList<StorageFile>. Cada arquivo é representado por um item do tipo StorageFile.

Implementações

CreateFileQuery()

Atributos

OverloadAttribute

Exemplos

O exemplo a seguir obtém um objeto de resultado de consulta que contém os arquivos na pasta atual chamando o 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());
 }
});

Comentários

Essa consulta é uma consulta superficial que retorna apenas arquivos na pasta atual. Para obter uma lista de métodos que identifica consultas superficiais e consultas profundas, consulte os Comentários no tópico GetFilesAsync.

Você também pode obter uma lista de arquivos na pasta atual de forma assíncrona chamando um dos métodos GetFilesAsync .

Para especificar opções de consulta adicionais, chame o método CreateFileQueryWithOptions .

Para obter itens que são arquivos ou pastas, chame o método CreateItemQuery .

Confira também

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions(QueryOptions)

CreateFileQuery(CommonFileQuery)

Obtém um objeto de resultado de consulta que contém os arquivos na pasta atual. Também obtém os arquivos das subpastas da pasta atual quando o valor do argumento de consulta é algo diferente de CommonFileQuery.DefaultQuery. Os arquivos são classificados com base no 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

Um dos valores de enumeração que especifica como classificar os arquivos e determina se a consulta é superficial ou profunda.

Retornos

StorageFileQueryResult

Um objeto de resultado da consulta. Chame o método GetFilesAsync do resultado da consulta para obter a lista simples de arquivos, classificada conforme especificado pela consulta. Esse método retorna uma lista do tipo IReadOnlyList<StorageFile>. Cada arquivo é representado por um item do tipo StorageFile.

Implementações

CreateFileQuery(CommonFileQuery)

Atributos

OverloadAttribute

Exceções

ArgumentException

Você especificou um valor diferente de DefaultQuery da <enumeração xref:Windows.Storage.Search.CommonFileQuery?text=CommonFileQuery> para uma pasta que não é uma pasta de biblioteca. Verifique o valor da consulta.

Comentários

Um CommonFileQuery classifica arquivos com base em atributos de arquivo específicos (como título ou data) de forma rápida e fácil.

Quando você especifica a opção DefaultQuery da enumeração CommonFileQuery , essa consulta é uma consulta superficial que retorna apenas arquivos na pasta atual. Quando você especifica outro valor da enumeração CommonFileQuery , essa consulta é uma consulta profunda que retorna uma lista nivelada de arquivos da pasta atual e de suas subpastas.

Dica

Alguns dos valores da enumeração CommonFileQuery só podem ser usados com uma pasta de biblioteca (como a biblioteca Imagens) ou a pasta Homegroup. Além da opção DefaultQuery , você pode usar apenas as opções OrderByName e OrderBySearchRank com uma pasta que não é uma pasta de biblioteca.

Para obter uma lista de métodos que identifica consultas superficiais e consultas profundas, consulte os Comentários no tópico GetFilesAsync.

Para marcar se um CommonFileQuery específico está disponível, chame o método IsCommonFileQuerySupported da pasta.

Você também pode obter uma lista de arquivos na pasta atual de forma assíncrona chamando um dos métodos GetFilesAsync .

Para Windows Server 2012 Você deve instalar componentes do indexador para usar alguns valores CommonFileQuery porque os componentes do indexador não são instalados por padrão.

Confira também

• CreateFileQuery()
• CreateFileQueryWithOptions(QueryOptions)