CommonFolderQuery Enumerazione

Definizione

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 CommonFolderQuery
var value = Windows.Storage.Search.CommonFolderQuery.defaultQuery
Public 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.

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.

Si applica a

Vedi anche