KnownFolders Classe

Référence

Définition

Espace de noms:: Windows.Storage

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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: ContractVersionAttribute MarshalingBehaviorAttribute

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 .

Pour plus d’informations sur l’utilisation des images, de la musique et des vidéos dans votre application, consultez Audio, vidéo et appareil photo.
Pour obtenir des informations générales sur l’utilisation des fichiers et dossiers, consultez Énumérer et interroger des fichiers et dossiers.

En savoir plus

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

Obtenez le dossier local de l’application à partir de la propriété Windows.Storage.ApplicationData.Current.LocalFolder .
Obtenez le dossier d’installation de l’application à partir de la propriété Windows.ApplicationModel.Package.Current.InstalledLocation .

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 à