KnownFolders Clase

Definición

Espacio de nombres:

Windows.Storage

Proporciona acceso a ubicaciones comunes que contienen contenido de usuario. Esto incluye contenido de las bibliotecas locales de un usuario (como Documentos, Imágenes, Música y Vídeos), Grupo Hogar, dispositivos extraíbles y dispositivos de servidor multimedia.

public ref class KnownFolders abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class KnownFolders final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class KnownFolders

Public Class KnownFolders

Herencia

Object Platform::Object IInspectable KnownFolders

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

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)

Ejemplos

En el ejemplo de acceso a archivos se muestra cómo usar la propiedad PicturesLibrary para crear un nuevo archivo en la biblioteca Imágenes.

StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.

Una vez completado el método CreateFileAsync , la file variable contiene un storageFile que representa el nuevo archivo.

Comentarios

Esta clase es estática y no se puede crear una instancia de ella. Acceda directamente a sus propiedades, como se muestra en el ejemplo siguiente.

• StorageFolder storageFolder = KnownFolders.PicturesLibrary;

Requisitos previos

Para acceder a las carpetas y bibliotecas representadas por las propiedades de esta clase, especifique las funcionalidades correspondientes en el manifiesto de la aplicación. Por ejemplo, para acceder a KnownFolders.PicturesLibrary, especifique la funcionalidad Biblioteca de imágenes en el manifiesto de la aplicación. Obtenga más información sobre las funcionalidades de las declaraciones de funcionalidad de la aplicación.

Valor devuelto

Las propiedades de la clase KnownFolders devuelven storageFolder. Para trabajar con la carpeta conocida y su contenido, llame a los métodos y propiedades de la clase StorageFolder .

• Para obtener información sobre cómo usar imágenes, música y vídeos en la aplicación, consulta Audio, vídeo y cámara.
• Para obtener información general sobre cómo usar archivos y carpetas, vea Enumerar y consultar archivos y carpetas.

Más información

A continuación se muestra cómo acceder a otras ubicaciones que se usan habitualmente.

• Obtenga la carpeta local de la aplicación desde la propiedad Windows.Storage.ApplicationData.Current.LocalFolder .
• Obtenga la carpeta de instalación de la aplicación desde la propiedad Windows.ApplicationModel.Package.Current.InstalledLocation .

Para obtener más información sobre las ubicaciones a las que puede acceder la aplicación, consulte Permisos de acceso a archivos.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1511	10586	GetFolderForUserAsync
2004	19041	GetFolderAsync
2004	19041	RequestAccessAsync
2004	19041	RequestAccessForUserAsync

Propiedades

AppCaptures	Obtiene la carpeta Capturas de aplicación.
CameraRoll	Obtiene la carpeta Roll de cámara.
DocumentsLibrary	Obtiene la biblioteca De documentos. La biblioteca Documentos no está pensada para uso general.
HomeGroup	Obtiene la carpeta HomeGroup.
MediaServerDevices	Obtiene la carpeta de dispositivos del servidor multimedia (Digital Living Network Alliance (DLNA)).
MusicLibrary	Obtiene la biblioteca de música.
Objects3D	Obtiene la carpeta Objetos 3D.
PicturesLibrary	Obtiene la biblioteca Imágenes.
Playlists	Obtiene la carpeta listas de reproducción.
RecordedCalls	Obtiene la carpeta de llamadas grabadas.
RemovableDevices	Obtiene la carpeta de dispositivos extraíbles.
SavedPictures	Obtiene la carpeta Imágenes guardadas.
VideosLibrary	Obtiene la biblioteca vídeos.

Métodos

GetFolderAsync(KnownFolderId)	Recupera la carpeta para el valor de folderId especificado.
GetFolderForUserAsync(User, KnownFolderId)	Método estático que devuelve una carpeta conocida especificada para un usuario.
RequestAccessAsync(KnownFolderId)	Solicita acceso para la funcionalidad que controla el acceso a la carpeta.
RequestAccessForUserAsync(User, KnownFolderId)	Solicita acceso para el usuario y folderId.

Consulte también

• StorageFile
• StorageFolder
• Windows.Storage.Search
• Ejemplo de acceso a archivos
• Permisos de acceso a archivos
• Enumerar y consultar archivos y carpetas
• Ejemplo de grupo hogar (Windows 10)