CommonFolderQuery Enumerazione

Definizione

Spazio dei nomi:

Windows.Storage.Search

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à

Enum

CommonFolderQuery

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

Nome	Valore	Descrizione
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.

Vedi anche

• QueryOptions(CommonFolderQuery)
• StorageFolder
• Esempio di enumerazione folder (Windows 10)