StorageFolder.CreateFileQuery Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Overload

CreateFileQuery()	Ottiene un oggetto risultato della query contenente i file nella cartella corrente.
CreateFileQuery(CommonFileQuery)	Ottiene un oggetto risultato della query contenente i file nella cartella corrente. Ottiene anche i file dalle sottocartelle della cartella corrente quando il valore dell'argomento di query è diverso da CommonFileQuery.DefaultQuery. I file vengono ordinati in base all'oggetto CommonFileQuery specificato.

CreateFileQuery()

Ottiene un oggetto risultato della query contenente i file nella cartella corrente.

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

Restituisce

StorageFileQueryResult

Oggetto risultato query. Chiamare il metodo GetFilesAsync del risultato della query per ottenere l'elenco flat di file. Questo metodo restituisce un elenco di tipo IReadOnlyList<StorageFile>. Ogni file è rappresentato da un elemento di tipo StorageFile.

Implementazioni

CreateFileQuery()

Attributi

OverloadAttribute

Esempio

L'esempio seguente ottiene un oggetto risultato della query contenente i file nella cartella corrente chiamando il metodo 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());
 }
});

Commenti

Questa query è una query superficiale che restituisce solo i file nella cartella corrente. Per un elenco di metodi che identificano query superficiali e query profonde, vedere le osservazioni nell'argomento GetFilesAsync.

È anche possibile ottenere un elenco di file nella cartella corrente in modo asincrono chiamando uno dei metodi GetFilesAsync .

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

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

Vedi anche

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions(QueryOptions)

CreateFileQuery(CommonFileQuery)

Ottiene un oggetto risultato della query contenente i file nella cartella corrente. Ottiene anche i file dalle sottocartelle della cartella corrente quando il valore dell'argomento di query è diverso da CommonFileQuery.DefaultQuery. I file vengono ordinati in base all'oggetto CommonFileQuery specificato.

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

Parametri

query

CommonFileQuery

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

Restituisce

StorageFileQueryResult

Oggetto risultato query. Chiamare il metodo GetFilesAsync del risultato della query per ottenere l'elenco flat di file, ordinati come specificato dalla query. Questo metodo restituisce un elenco di tipo IReadOnlyList<StorageFile>. Ogni file è rappresentato da un elemento di tipo StorageFile.

Implementazioni

CreateFileQuery(CommonFileQuery)

Attributi

OverloadAttribute

Eccezioni

ArgumentException

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

Commenti

Un file CommonFileQuery ordina i file in base a attributi di file specifici (ad esempio titolo o data) rapidamente e facilmente.

Quando si specifica l'opzione DefaultQuery dall'enumerazione CommonFileQuery , questa query è una query superficiale che restituisce solo file nella cartella corrente. Quando si specifica un altro valore dall'enumerazione CommonFileQuery , questa query è una query profonda che restituisce un elenco flat di file dalla cartella corrente e dalle relative sottocartelle.

Suggerimento

Alcuni dei valori dell'enumerazione CommonFileQuery possono essere usati solo con una cartella di libreria (ad esempio la libreria Immagini) o la cartella Homegroup. Oltre all'opzione DefaultQuery , è possibile usare solo le opzioni OrderByName e OrderBySearchRank con una cartella che non è una cartella di libreria.

Per un elenco di metodi che identificano query superficiali e query profonde, vedere le osservazioni nell'argomento GetFilesAsync.

Per verificare se è disponibile un commonFileQuery specifico, chiamare il metodo IsCommonFileQuerySupported della cartella.

È anche possibile ottenere un elenco di file nella cartella corrente in modo asincrono chiamando uno dei metodi GetFilesAsync .

Per Windows Server 2012 È necessario installare i componenti dell'indicizzatore per usare alcuni valori CommonFileQuery perché i componenti dell'indicizzatore non sono installati per impostazione predefinita.

Vedi anche

• CreateFileQuery()
• CreateFileQueryWithOptions(QueryOptions)