CommonFolderQuery Enumeración

Definición

Espacio de nombres:

Windows.Storage.Search

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

Enum

CommonFolderQuery

Atributos

ContractVersionAttribute

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.

Consulte también

• QueryOptions(CommonFolderQuery)
• StorageFolder
• Ejemplo de enumeración de carpetas (Windows 10)