CommonFolderQuery Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 CommonFolderQueryvar value = Windows.Storage.Search.CommonFolderQuery.defaultQueryPublic 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.
- 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.