Partager via


KnownFolders Classe

Définition

Fournit l’accès aux emplacements courants qui contiennent du contenu utilisateur. Cela inclut le contenu des bibliothèques locales d’un utilisateur (tels que documents, images, musique et vidéos), du groupe résidentiel, des appareils amovibles et des appareils serveur multimédia.

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
Héritage
Object Platform::Object IInspectable KnownFolders
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple d’accès aux fichiers vous montre comment utiliser la propriété PicturesLibrary pour créer un fichier dans la bibliothèque Images.

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

Une fois la méthode CreateFileAsync terminée, la file variable contient un StorageFile qui représente le nouveau fichier.

Remarques

Cette classe est statique et ne peut pas être instanciée. Accédez directement à ses propriétés, comme illustré dans l’exemple suivant.

  • StorageFolder storageFolder = KnownFolders.PicturesLibrary;

Prérequis

Pour accéder aux dossiers et bibliothèques représentés par les propriétés de cette classe, spécifiez les fonctionnalités correspondantes dans le manifeste de votre application. Par exemple, pour accéder à KnownFolders.PicturesLibrary, spécifiez la fonctionnalité Bibliothèque d’images dans le manifeste de l’application. En savoir plus sur les fonctionnalités dans les déclarations de fonctionnalités d’application.

Valeur retournée

Les propriétés de la classe KnownFolders retournent un StorageFolder. Pour utiliser le dossier connu et son contenu, appelez les méthodes et les propriétés de la classe StorageFolder .

En savoir plus

Voici comment accéder à d’autres emplacements couramment utilisés.

Pour en savoir plus sur les emplacements auxquels votre application peut accéder, consultez Autorisations d’accès aux fichiers.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1511 10586 GetFolderForUserAsync
2004 19041 GetFolderAsync
2004 19041 RequestAccessAsync
2004 19041 RequestAccessForUserAsync

Propriétés

AppCaptures

Obtient le dossier App Captures.

CameraRoll

Obtient le dossier Pellicule.

DocumentsLibrary

Obtient la bibliothèque documents. La bibliothèque Documents n’est pas destinée à une utilisation générale.

HomeGroup

Obtient le dossier Groupe résidentiel.

MediaServerDevices

Obtient le dossier des appareils du serveur multimédia (Digital Living Network Alliance (DLNA)).

MusicLibrary

Obtient la bibliothèque de musique.

Objects3D

Obtient le dossier Objects 3D.

PicturesLibrary

Obtient la bibliothèque d’images.

Playlists

Obtient le dossier play lists.

RecordedCalls

Obtient le dossier des appels enregistrés.

RemovableDevices

Obtient le dossier des appareils amovibles.

SavedPictures

Obtient le dossier Images enregistrées.

VideosLibrary

Obtient la bibliothèque de vidéos.

Méthodes

GetFolderAsync(KnownFolderId)

Récupère le dossier pour le folderId spécifié.

GetFolderForUserAsync(User, KnownFolderId)

Méthode statique qui retourne un dossier connu spécifié pour un utilisateur.

RequestAccessAsync(KnownFolderId)

Demande l’accès pour la fonctionnalité de contrôle de l’accès au dossier.

RequestAccessForUserAsync(User, KnownFolderId)

Demande l’accès pour l’utilisateur et folderId.

S’applique à

Voir aussi