Compartir a través de


CommonFolderQuery Enumeración

Definición

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 CommonFolderQuery
var value = Windows.Storage.Search.CommonFolderQuery.defaultQuery
Public 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.

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.

Se aplica a

Consulte también