CommonFileQuery Enumerazione

Definizione

Spazio dei nomi:

Windows.Storage.Search

Specifica come ordinare i file nei risultati della query e determina se la query è superficiale o profonda. I risultati delle query per le query profonde includono tutti i file in tutte le sottocartelle della cartella corrente, ordinati in base all'opzione specificata.

public enum class CommonFileQuery

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class CommonFileQuery

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum CommonFileQuery

var value = Windows.Storage.Search.CommonFileQuery.defaultQuery

Public Enum CommonFileQuery

Ereditarietà

Enum

CommonFileQuery

Attributi

ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Campi

DefaultQuery	0	Elenco superficiale dei file nella cartella corrente, simile all'elenco fornito da Esplora file. È possibile usare questa opzione per qualsiasi posizione di archiviazione.
OrderByDate	5	Elenco completo e flat di file in una cartella e nelle relative sottocartelle, ordinato da System.ItemDate. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. Nota System.ItemDate è una proprietà calcolata che cambia in base al tipo di contenuto; ad esempio, esegue il mapping a System.Photo.DateTaken per le foto.
OrderByMusicProperties	3	Elenco completo e flat di file in una cartella e nelle relative sottocartelle, ordinati in base alle proprietà musicali. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup.
OrderByName	1	Elenco completo e flat di file in una cartella e nelle relative sottocartelle, ordinati in base a System.ItemNameDisplay. È possibile usare questa opzione per qualsiasi posizione di archiviazione.
OrderBySearchRank	4	Elenco completo e flat di file in una cartella e nelle relative sottocartelle, ordinato da System.Search.Rank seguito da System.DateModified. È possibile usare questa opzione per qualsiasi posizione di archiviazione.
OrderByTitle	2	Elenco completo e flat di file in una cartella e nelle relative sottocartelle, ordinati in base a System.Title. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup.

Commenti

Usare un valore dall'enumerazione CommonFileQuery quando si chiama uno dei metodi seguenti della classe StorageFolder . Per esempi che usano valori dall'enumerazione CommonFileQuery, vedere gli argomenti per questi metodi.

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions. Creare un'istanza di QueryOptions con il costruttore QueryOptions(CommonFileQuery, IIterable(String)).
• CreateItemQueryWithOptions. Creare un'istanza di QueryOptions con il costruttore QueryOptions(CommonFileQuery, IIterable(String)).
• GetFilesAsync(CommonFileQuery)
• GetFilesAsync(CommonFileQuery, UInt32, UInt32)

Questi metodi usano il valore dell'enumerazione CommonFileQuery per inizializzare le opzioni FolderDepth, IndexerOption e SortOrder della query.

Chiamare il metodo StorageFolder.IsCommonFileQuerySupported per determinare se il valore CommonFileQuery che si vuole usare è disponibile per la cartella corrente.

Suggerimento

I file che non hanno un valore per la proprietà usata dalla query per ordinare i file vengono in genere esclusi dai risultati delle query.

Vedi anche

• Esempio di enumerazione cartella (Windows 10)