Compartir a través de


KnownFolders Clase

Definición

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

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 .

Más información

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

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.

Se aplica a

Consulte también