CommonFolderQuery Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica cómo agrupar archivos en carpetas en los resultados de la consulta y determina si la consulta es superficial o profunda. Los resultados de la consulta para consultas profundas incluyen todos los archivos de todas las subcarpetas de la carpeta actual, agrupados en carpetas según la opción 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- Herencia
-
CommonFolderQuery
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Campos
| DefaultQuery | 0 | Una lista superficial de las carpetas de la carpeta actual, similar a la vista que proporciona Explorador de archivos. Puede usar esta opción para cualquier ubicación de almacenamiento. |
| GroupByAlbum | 103 | Agrupa los archivos en carpetas virtuales por año en función de la propiedad System.Music.AlbumTitle de cada archivo. Cada carpeta contendrá todos los archivos (y solo) con valores idénticos para System.Music.AlbumTitle. Puede usar esta opción solo para carpetas de una biblioteca o la carpeta Grupo Hogar. |
| GroupByAlbumArtist | 104 | Agrupa los archivos en carpetas virtuales en función de la propiedad System.Music.AlbumArtist de cada archivo. Cada carpeta contendrá todos los archivos (y solo) con valores idénticos para System.Music.AlbumArtist. Puede usar esta opción solo para carpetas de una biblioteca o la carpeta Grupo Hogar. |
| GroupByArtist | 102 | Agrupa archivos en carpetas virtuales basadas en la propiedad System.Music.Artist de cada archivo. Cada carpeta contendrá todos los archivos (y solo) con valores idénticos para System.Music.Artist. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByAuthor | 110 | Agrupe los archivos en carpetas virtuales en función de la propiedad System.Author de cada archivo. Cada carpeta representará un autor y contendrá todos los archivos cuyo vector System.Author contiene ese autor. Si un archivo enumera varios autores, puede aparecer en más de una de las carpetas resultantes. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByComposer | 105 | Agrupe los archivos en carpetas virtuales en función de la propiedad System.Music.Composer de cada archivo. Cada carpeta representará un compositor y contendrá todos los archivos cuyo vector System.Music.Composer contiene ese compositor. Si un archivo enumera varios compositores, puede aparecer en más de una de las carpetas resultantes. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByGenre | 106 | Agrupe los archivos en carpetas virtuales basándose en la propiedad System.Music.Genre de cada archivo. Cada carpeta contendrá todos los archivos (y solo) con valores idénticos para System.Music.Genre. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByMonth | 101 | Agrupe los archivos en carpetas virtuales por mes en función de la propiedad System.ItemDate de cada archivo. Cada carpeta contendrá todos los archivos (y solo) que tengan valores para System.ItemDate en el mismo mes. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByPublishedYear | 107 | Agrupe los archivos en carpetas virtuales por año según la propiedad System.Media.Year de cada archivo. Cada carpeta contendrá todos los archivos (y solo) que tengan valores para System.Media.Year en el mismo año. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByRating | 108 | Agrupe los archivos en carpetas virtuales por clasificación (1 star, 2 estrellas, etc.) según la propiedad System.Rating de cada archivo. Cada carpeta contendrá todos los archivos (y solo) con valores idénticos para System.Rating. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByTag | 109 | Agrupe los archivos en carpetas virtuales en función de la propiedad System.Keywords de cada archivo. Cada carpeta representará una etiqueta y contendrá todos los archivos cuyo vector System.Keywords contenga esa etiqueta. Si un archivo enumera varias etiquetas en su vector System.Keywords , puede aparecer en más de una de las carpetas resultantes. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByType | 111 | Agrupe archivos en carpetas virtuales por tipo (por ejemplo, Documentos de Microsoft Word, archivos de texto, etc.) en función de la propiedad System.ItemTypeText de cada archivo. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
| GroupByYear | 100 | Agrupe los archivos en carpetas virtuales por año en función de la propiedad System.ItemDate de cada archivo. Cada carpeta contendrá todos los archivos (y solo) que tengan valores para System.ItemDate en el mismo año. Puede usar esta opción solo para las carpetas de una biblioteca o la carpeta Grupo hogar. |
Comentarios
Use un valor de la enumeración CommonFolderQuery cuando llame a uno de los métodos siguientes de la clase StorageFolder . Para obtener ejemplos que usan valores de la enumeración CommonFolderQuery, consulte los temas de estos métodos.
- CreateFolderQuery(CommonFolderQuery)
- CreateFolderQueryWithOptions. Cree una instancia de QueryOptions con el constructor QueryOptions(CommonFolderQuery).
- CreateItemQueryWithOptions. Cree una instancia de QueryOptions con el constructor QueryOptions(CommonFolderQuery).
- GetFoldersAsync(CommonFolderQuery)
- GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)
Estos métodos usan el valor de la enumeración CommonFolderQuery para inicializar las opciones DateStackOption, FolderDepth, IndexerOption y SortOrder de la consulta.
Llame al método StorageFolder.IsCommonFolderQuerySupported para determinar si el valor commonFolderQuery que desea usar está disponible para la carpeta actual.
Sugerencia
Cuando una consulta agrupa archivos en carpetas virtuales basadas en una propiedad que puede tener varios valores (por ejemplo, System.Author), un archivo determinado puede aparecer en más de una carpeta virtual porque cada carpeta representa uno de los varios valores.
Los archivos que no tienen un valor para la propiedad que usa la consulta para agrupar archivos normalmente se excluyen de los resultados de la consulta.