Compartilhar via


CommonFolderQuery Enumeração

Definição

Especifica como agrupar arquivos em pastas nos resultados da consulta e determina se a consulta é superficial ou profunda. Os resultados da consulta para consultas profundas incluem todos os arquivos em todas as subpastas da pasta atual, agrupados em pastas de acordo com a opção especificada.

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
Herança
CommonFolderQuery
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Campos

DefaultQuery 0

Uma lista superficial das pastas na pasta atual, semelhante à exibição que Explorador de Arquivos fornece.

Você pode usar essa opção para qualquer local de armazenamento.

GroupByAlbum 103

Agrupar arquivos em pastas virtuais por ano com base na propriedade System.Music.AlbumTitle de cada arquivo. Cada pasta conterá todos os arquivos (e somente) com valores idênticos para System.Music.AlbumTitle.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByAlbumArtist 104

Agrupar arquivos em pastas virtuais com base na propriedade System.Music.AlbumArtist de cada arquivo. Cada pasta conterá todos os arquivos (e somente) com valores idênticos para System.Music.AlbumArtist.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByArtist 102

Agrupar arquivos em pastas virtuais com base na propriedade System.Music.Artist de cada arquivo. Cada pasta conterá todos os arquivos (e somente) com valores idênticos para System.Music.Artist.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByAuthor 110

Agrupe arquivos em pastas virtuais com base na propriedade System.Author de cada arquivo. Cada pasta representará um autor e conterá todos os arquivos cujo vetor System.Author contém esse autor. Se um arquivo listar vários autores, ele poderá aparecer em mais de uma das pastas resultantes.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByComposer 105

Agrupe arquivos em pastas virtuais com base na propriedade System.Music.Composer de cada arquivo. Cada pasta representará um compositor e conterá todos os arquivos cujo vetor System.Music.Composer contém esse compositor. Se um arquivo listar vários compositores, ele poderá aparecer em mais de uma das pastas resultantes.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByGenre 106

Agrupe arquivos em pastas virtuais com base na propriedade System.Music.Genre de cada arquivo. Cada pasta conterá todos os arquivos (e somente) com valores idênticos para System.Music.Genre.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByMonth 101

Agrupe arquivos em pastas virtuais por mês com base na propriedade System.ItemDate de cada arquivo. Cada pasta conterá todos os arquivos (e somente) que têm valores para System.ItemDate no mesmo mês.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByPublishedYear 107

Agrupe arquivos em pastas virtuais por ano com base na propriedade System.Media.Year de cada arquivo. Cada pasta conterá todos os arquivos (e somente) que têm valores para System.Media.Year no mesmo ano.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByRating 108

Agrupe arquivos em pastas virtuais por classificação (1 star, 2 estrelas e assim por diante) com base na propriedade System.Rating de cada arquivo. Cada pasta conterá todos os arquivos (e somente) com valores idênticos para System.Rating.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByTag 109

Agrupe arquivos em pastas virtuais com base na propriedade System.Keywords de cada arquivo. Cada pasta representará uma marca e conterá todos os arquivos cujo vetor System.Keywords contém essa marca. Se um arquivo listar várias marcas em seu vetor System.Keywords , ele poderá aparecer em mais de uma das pastas resultantes.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByType 111

Agrupe arquivos em pastas virtuais por tipo (por exemplo, documentos do Microsoft Word, arquivos de texto e assim por diante) com base na propriedade System.ItemTypeText de cada arquivo.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

GroupByYear 100

Agrupe arquivos em pastas virtuais por ano com base na propriedade System.ItemDate de cada arquivo. Cada pasta conterá todos os arquivos (e somente) que têm valores para System.ItemDate no mesmo ano.

Você pode usar essa opção somente para pastas em uma biblioteca ou na pasta HomeGroup.

Comentários

Use um valor da enumeração CommonFolderQuery ao chamar um dos métodos a seguir da classe StorageFolder . Para obter exemplos que usam valores da enumeração CommonFolderQuery, consulte os tópicos para esses métodos.

Esses métodos usam o valor da enumeração CommonFolderQuery para inicializar as opções DateStackOption, FolderDepth, IndexerOption e SortOrder da consulta.

Chame o método StorageFolder.IsCommonFolderQuerySupported para determinar se o valor CommonFolderQuery que você deseja usar está disponível para a pasta atual.

Dica

Quando uma consulta agrupa arquivos em pastas virtuais com base em uma propriedade que pode ter vários valores (por exemplo, System.Author), um arquivo específico pode aparecer em mais de uma pasta virtual porque cada pasta representa um dos vários valores.

Arquivos que não têm um valor para a propriedade que a consulta usa para agrupar arquivos normalmente são excluídos dos resultados da consulta.

Aplica-se a

Confira também