CommonFileQuery Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 CommonFileQueryvar value = Windows.Storage.Search.CommonFileQuery.defaultQueryPublic Enum CommonFileQuery- Ereditarietà
-
CommonFileQuery
- Attributi
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.