StorageFolder.CreateFileQuery Methode

Definition

Namespace:

Windows.Storage

Überlädt

CreateFileQuery()	Ruft ein Abfrageergebnisobjekt ab, das die Dateien im aktuellen Ordner enthält.
CreateFileQuery(CommonFileQuery)	Ruft ein Abfrageergebnisobjekt ab, das die Dateien im aktuellen Ordner enthält. Ruft auch die Dateien aus den Unterordnern des aktuellen Ordners ab, wenn der Wert des Abfragearguments etwas anderes als CommonFileQuery.DefaultQuery ist. Dateien werden basierend auf der angegebenen CommonFileQuery sortiert.

CreateFileQuery()

Ruft ein Abfrageergebnisobjekt ab, das die Dateien im aktuellen Ordner enthält.

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

Gibt zurück

StorageFileQueryResult

Ein Abfrageergebnisobjekt. Rufen Sie die GetFilesAsync-Methode des Abfrageergebnisses auf, um die flache Liste der Dateien abzurufen. Diese Methode gibt eine Liste vom Typ IReadOnlyList<StorageFile> zurück. Jede Datei wird durch ein Element vom Typ StorageFile dargestellt.

Implementiert

CreateFileQuery()

Attribute

OverloadAttribute

Beispiele

Im folgenden Beispiel wird ein Abfrageergebnisobjekt abgerufen, das die Dateien im aktuellen Ordner enthält, indem die CreateFileQuery()-Methode aufgerufen wird.

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

Hinweise

Diese Abfrage ist eine flache Abfrage, die nur Dateien im aktuellen Ordner zurückgibt. Eine Liste der Methoden, die flache Abfragen und tiefe Abfragen identifizieren, finden Sie in den Hinweisen im Thema GetFilesAsync.

Sie können auch eine Liste der Dateien im aktuellen Ordner asynchron abrufen, indem Sie eine der GetFilesAsync-Methoden aufrufen.

Um zusätzliche Abfrageoptionen anzugeben, rufen Sie die CreateFileQueryWithOptions-Methode auf.

Um Elemente abzurufen, die Dateien oder Ordner sind, rufen Sie die CreateItemQuery-Methode auf.

Weitere Informationen

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions(QueryOptions)

CreateFileQuery(CommonFileQuery)

Ruft ein Abfrageergebnisobjekt ab, das die Dateien im aktuellen Ordner enthält. Ruft auch die Dateien aus den Unterordnern des aktuellen Ordners ab, wenn der Wert des Abfragearguments etwas anderes als CommonFileQuery.DefaultQuery ist. Dateien werden basierend auf der angegebenen CommonFileQuery sortiert.

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

Parameter

query

CommonFileQuery

Einer der Enumerationswerte, der angibt, wie die Dateien sortiert werden sollen, und bestimmt, ob die Abfrage flach oder tief ist.

Gibt zurück

StorageFileQueryResult

Ein Abfrageergebnisobjekt. Rufen Sie die GetFilesAsync-Methode des Abfrageergebnisses auf, um die flache Liste der Dateien abzurufen, die nach Abfrage sortiert werden. Diese Methode gibt eine Liste vom Typ IReadOnlyList<StorageFile> zurück. Jede Datei wird durch ein Element vom Typ StorageFile dargestellt.

Implementiert

CreateFileQuery(CommonFileQuery)

Attribute

OverloadAttribute

Ausnahmen

ArgumentException

Sie haben einen anderen Wert als DefaultQuery aus der <xref:Windows.Storage.Search.CommonFileQuery?text=CommonFileQuery-Enumeration> für einen Ordner angegeben, der kein Bibliotheksordner ist. Überprüfen Sie den Wert der Abfrage.

Hinweise

Eine CommonFileQuery sortiert Dateien schnell und einfach nach bestimmten Dateiattributen (z. B. Titel oder Datum).

Wenn Sie die Option DefaultQuery aus der CommonFileQuery-Enumeration angeben, handelt es sich bei dieser Abfrage um eine flache Abfrage, die nur Dateien im aktuellen Ordner zurückgibt. Wenn Sie einen anderen Wert aus der CommonFileQuery-Enumeration angeben, ist diese Abfrage eine tiefe Abfrage, die eine vereinfachte Liste von Dateien aus dem aktuellen Ordner und seinen Unterordnern zurückgibt.

Tipp

Einige der Werte aus der CommonFileQuery-Enumeration können nur mit einem Bibliotheksordner (z. B. der Bildbibliothek) oder dem Ordner Heimnetzgruppe verwendet werden. Zusätzlich zur Option DefaultQuery können Sie nur die Optionen OrderByName und OrderBySearchRank mit einem Ordner verwenden, der kein Bibliotheksordner ist.

Eine Liste der Methoden, die flache Abfragen und tiefe Abfragen identifizieren, finden Sie in den Hinweisen im Thema GetFilesAsync.

Um zu überprüfen, ob eine bestimmte CommonFileQuery verfügbar ist, rufen Sie die IsCommonFileQuerySupported-Methode des Ordners auf.

Sie können auch eine Liste der Dateien im aktuellen Ordner asynchron abrufen, indem Sie eine der GetFilesAsync-Methoden aufrufen.

Für Windows Server 2012 Sie müssen Indexerkomponenten installieren, um einige CommonFileQuery-Werte zu verwenden, da Indexerkomponenten nicht standardmäßig installiert sind.

Weitere Informationen

• CreateFileQuery()
• CreateFileQueryWithOptions(QueryOptions)