StorageFolder.AreQueryOptionsSupported(QueryOptions) Methode

Definition

Namespace:

Windows.Storage

Gibt an, ob der aktuelle Ordner die angegebenen QueryOptions unterstützt.

public:
 virtual bool AreQueryOptionsSupported(QueryOptions ^ queryOptions) = AreQueryOptionsSupported;

bool AreQueryOptionsSupported(QueryOptions const& queryOptions);

public bool AreQueryOptionsSupported(QueryOptions queryOptions);

function areQueryOptionsSupported(queryOptions)

Public Function AreQueryOptionsSupported (queryOptions As QueryOptions) As Boolean

Parameter

queryOptions

QueryOptions

Die zu überprüfenden QueryOptions .

Gibt zurück

Boolean

bool

True, wenn der Ordner oder die Dateigruppe die angegebenen QueryOptions unterstützt; andernfalls false.

Implementiert

AreQueryOptionsSupported(QueryOptions)

Hinweise

Mit QueryOptions können Sie Dateien in einem Ordner und seinen Unterordnern auflisten, indem Sie Kriterien angeben, die Sie dann verwenden können, um ein Abfrageergebnisobjekt von Dateien in diesem Ordner und unterordnern zu erstellen. Die CommonFileQuery- und CommonFolderQuery-Enumeration stellen einige der häufigsten Kriterien dar, die zum Filtern und Auflisten von Dateien und Ordnern verwendet werden.

Verwenden Sie die AreQueryOptionsSupported-Methode, um zu überprüfen, ob die QueryOptions , die Sie angeben möchten, für den aktuellen Ordner verfügbar sind. Sie können auch überprüfen, ob ein bestimmter CommonFileQuery - oder CommonFolderQuery-Wert verfügbar ist, indem Sie IsCommonFileQuerySupported bzw. IsCommonFolderQuerySupported aufrufen.

Die für Sie verfügbaren spezifischen Optionen hängen davon ab, wo sich die Dateien oder Ordner befinden, die Sie auflisten möchten. Für Ordner und Dateien, die sich in einer Bibliothek oder Heimnetzgruppe befinden, können Sie eine beliebige Kombination von QueryOptions verwenden.

Ordner und Dateien außerhalb einer Bibliothek oder Heimnetzgruppe unterstützen nur einen Teil der Optionen.

• Für Abfragen, die nur die Dateien oder Ordner der obersten Ebene auflisten (auch als flache Abfrage bezeichnet), erstellen Sie ein QueryOptions-Objekt auf eine der folgenden drei Arten:

  • Rufen Sie den Standardkonstruktor QueryOptions() auf.
  • Rufen Sie den QueryOptions(CommonFolderQuery) -Konstruktor auf, und geben Sie CommonFolderQuery an. DefaultQuery.
  • Rufen Sie den Konstruktor QueryOptions(CommonFileQuery, IIterable(String)) auf, und geben Sie CommonFileQuery an. DefaultQuery. Sie können weiterhin dateitypen angeben, die gefiltert werden sollen, wenn Sie diesen Konstruktor verwenden.

• Erstellen Sie für Abfragen, die alle Dateien im aktuellen Ordner und seinen Unterordnern (auch als Deep Query bezeichnet) aufzählen, ein QueryOptions-Objekt auf eine der folgenden beiden Arten:

  • Rufen Sie den QueryOptions(CommonFolderQuery) -Konstruktor auf, und geben Sie CommonFileQuery an. OrderByName oder CommonFileQuery. OrderBySearchRank.
  • Rufen Sie den Konstruktor QueryOptions(CommonFileQuery, IIterable(String)) auf, und geben Sie CommonFileQuery an. OrderByName oder CommonFileQuery. OrderBySearchRank. Sie können weiterhin dateitypen angeben, die gefiltert werden sollen, wenn Sie diesen Konstruktor verwenden.

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