StorageFolder.AreQueryOptionsSupported(QueryOptions) Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Indica se la cartella corrente supporta QueryOptions specificata.

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

Parametri

queryOptions

QueryOptions

QueryOptions da controllare.

Restituisce

Boolean

bool

True se la cartella o il gruppo di file supporta l'opzione QueryOptions specificata; in caso contrario false.

Implementazioni

AreQueryOptionsSupported(QueryOptions)

Commenti

QueryOptions consente di enumerare i file in una cartella e le relative sottocartelle, consentendo di specificare i criteri che è quindi possibile usare per creare un oggetto risultato di query di file in tale cartella e sottocartelle. L'enumerazione CommonFileQuery e CommonFolderQuery rappresentano alcuni dei criteri più comuni usati per filtrare ed enumerare file e cartelle.

Usare il metodo AreQueryOptionsSupported per verificare che QueryOptions da specificare sia disponibile per la cartella corrente. È anche possibile verificare se è disponibile un valore CommonFileQuery o CommonFolderQuery specifico, chiamando rispettivamente IsCommonFileQuerySupported o IsCommonFolderQuerySupported.

Le opzioni specifiche disponibili dipendono dalla posizione in cui si trovano i file o le cartelle da enumerare. Per cartelle e file che si trovano all'interno di una libreria o di un homegroup, è possibile usare qualsiasi combinazione di QueryOptions.

Cartelle e file all'esterno di una libreria o di un gruppo homegroup supportano un solo subset di opzioni.

• Per le query che enumerano solo i file o le cartelle di primo livello (nota anche come query superficiale), creare un oggetto QueryOptions in uno dei tre modi seguenti:

  • Chiamare il costruttore QueryOptions() predefinito.
  • Chiamare il costruttore QueryOptions(CommonFolderQuery) e specificare CommonFolderQuery. DefaultQuery.
  • Chiamare il costruttore QueryOptions(CommonFileQuery, IIterable(String)) e specificare CommonFileQuery. DefaultQuery. È comunque possibile specificare i tipi di file da filtrare quando si usa questo costruttore.

• Per le query che enumerano tutti i file all'interno della cartella corrente e le relative sottocartelle (note anche come query profonde), creare un oggetto QueryOptions in uno dei due modi seguenti:

  • Chiamare il costruttore QueryOptions(CommonFolderQuery) e specificare CommonFileQuery. OrderByName o CommonFileQuery. OrderBySearchRank.
  • Chiamare il costruttore QueryOptions(CommonFileQuery, IIterable(String)) e specificare CommonFileQuery. OrderByName o CommonFileQuery. OrderBySearchRank. È comunque possibile specificare i tipi di file da filtrare quando si usa questo costruttore.

Per Windows Server 2012 È necessario installare i componenti dell'indicizzatore per usare alcuni valori QueryOptions, CommonFileQuery e Valori CommonFolderQuery perché i componenti dell'indicizzatore non vengono installati per impostazione predefinita.