CommonFolderQuery 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 raggruppare i file in cartelle nei risultati della query e determina se la query è superficiale o profonda. I risultati delle query per le query approfondite includono tutti i file in tutte le sottocartelle della cartella corrente, raggruppate in cartelle in base all'opzione specificata.
public enum class CommonFolderQuery/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class CommonFolderQuery[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum CommonFolderQueryvar value = Windows.Storage.Search.CommonFolderQuery.defaultQueryPublic Enum CommonFolderQuery- Ereditarietà
-
CommonFolderQuery
- 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 delle cartelle nella cartella corrente, simile alla visualizzazione fornita Esplora file. È possibile usare questa opzione per qualsiasi percorso di archiviazione. |
| GroupByAlbum | 103 | Raggruppare i file in cartelle virtuali per anno in base alla proprietà System.Music.AlbumTitle di ogni file. Ogni cartella conterrà tutti i file (e solo) con valori identici per System.Music.AlbumTitle. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByAlbumArtist | 104 | Raggruppare i file in cartelle virtuali in base alla proprietà System.Music.AlbumArtist di ogni file. Ogni cartella conterrà tutti i file (e solo) con valori identici per System.Music.AlbumArtist. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByArtist | 102 | Raggruppare i file in cartelle virtuali in base alla proprietà System.Music.Artist di ogni file. Ogni cartella conterrà tutti i file (e solo) con valori identici per System.Music.Artist. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByAuthor | 110 | Raggruppare i file in cartelle virtuali in base alla proprietà System.Author di ogni file. Ogni cartella rappresenta un autore e contiene tutti i file il cui vettore System.Author contiene tale autore. Se un file elenca più autori, può essere visualizzato in più di una delle cartelle risultanti. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByComposer | 105 | Raggruppare i file in cartelle virtuali in base alla proprietà System.Music.Composer di ogni file. Ogni cartella rappresenta un compositore e contiene tutti i file il cui vettore System.Music.Composer contiene tale compositore. Se un file elenca più compositori, può essere visualizzato in più di una delle cartelle risultanti. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByGenre | 106 | Raggruppare i file in cartelle virtuali in base alla proprietà System.Music.Genre di ogni file. Ogni cartella conterrà tutti i file (e solo) con valori identici per System.Music.Genre. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByMonth | 101 | Raggruppare i file in cartelle virtuali per mese in base alla proprietà System.ItemDate di ogni file. Ogni cartella conterrà tutti i file (e solo) con valori per System.ItemDate nello stesso mese. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByPublishedYear | 107 | Raggruppare i file in cartelle virtuali per anno in base alla proprietà System.Media.Year di ogni file. Ogni cartella conterrà tutti i file (e solo) con valori per System.Media.Year nello stesso anno. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByRating | 108 | Raggruppare i file in cartelle virtuali in base alla classificazione (1 star, 2 stelle e così via) in base alla proprietà System.Rating di ogni file. Ogni cartella conterrà tutti i file (e solo) con valori identici per System.Rating. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByTag | 109 | Raggruppare i file in cartelle virtuali in base alla proprietà System.Keywords di ogni file. Ogni cartella rappresenta un tag e contiene tutti i file il cui vettore System.Keywords contiene tale tag. Se un file elenca più tag nel vettore System.Keywords , può essere visualizzato in più di una delle cartelle risultanti. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByType | 111 | Raggruppare i file in cartelle virtuali per tipo (ad esempio, Microsoft Word documenti, file di testo e così via) in base alla proprietà System.ItemTypeText di ogni file. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
| GroupByYear | 100 | Raggruppare i file in cartelle virtuali per anno in base alla proprietà System.ItemDate di ogni file. Ogni cartella conterrà tutti i file (e solo) con valori per System.ItemDate nello stesso anno. È possibile usare questa opzione solo per le cartelle in una raccolta o nella cartella HomeGroup. |
Commenti
Usare un valore dell'enumerazione CommonFolderQuery quando si chiama uno dei metodi seguenti della classe StorageFolder . Per esempi che usano valori dell'enumerazione CommonFolderQuery, vedere gli argomenti per questi metodi.
- CreateFolderQuery(CommonFolderQuery)
- CreateFolderQueryWithOptions. Creare un'istanza di QueryOptions con il costruttore QueryOptions(CommonFolderQuery).
- CreateItemQueryWithOptions. Creare un'istanza di QueryOptions con il costruttore QueryOptions(CommonFolderQuery).
- GetFoldersAsync(CommonFolderQuery)
- GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)
Questi metodi usano il valore dell'enumerazione CommonFolderQuery per inizializzare le opzioni DateStackOption, FolderDepth, IndexerOption e SortOrder della query.
Chiamare il metodo StorageFolder.IsCommonFolderQuerySupported per determinare se il valore CommonFolderQuery che si desidera utilizzare è disponibile per la cartella corrente.
Suggerimento
Quando una query raggruppa i file in cartelle virtuali in base a una proprietà che può avere più valori (ad esempio System.Author), un particolare file può essere visualizzato in più di una cartella virtuale perché ogni cartella rappresenta uno dei più valori.
I file che non hanno un valore per la proprietà usata dalla query per raggruppare i file vengono in genere esclusi dai risultati della query.