KnownFolders Clase
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í.
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 KnownFoldersPublic Class KnownFolders- Herencia
- 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 .
- 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. |