CommonFolderQuery Enumeração

Definição

Namespace:

Windows.Storage.Search

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

Enum

CommonFolderQuery

Atributos

ContractVersionAttribute

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.

• CreateFolderQuery(CommonFolderQuery)
• CreateFolderQueryWithOptions. Instancie o QueryOptions com o construtor QueryOptions(CommonFolderQuery).
• CreateItemQueryWithOptions. Instancie o QueryOptions com o construtor QueryOptions(CommonFolderQuery).
• GetFoldersAsync(CommonFolderQuery)
• GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

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.

Confira também

• QueryOptions(CommonFolderQuery)
• StorageFolder
• Exemplo de enumeração de pasta (Windows 10)