KnownFolders.DocumentsLibrary Propriété

Définition

Espace de noms:

Windows.Storage

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

public:
 static property StorageFolder ^ DocumentsLibrary { StorageFolder ^ get(); };

static StorageFolder DocumentsLibrary();

public static StorageFolder DocumentsLibrary { get; }

var storageFolder = KnownFolders.documentsLibrary;

Public Shared ReadOnly Property DocumentsLibrary As StorageFolder

Valeur de propriété

StorageFolder

Bibliothèque documents.

Configuration requise pour Windows

Fonctionnalités de l’application

documentsLibrary

Remarques

Important

La bibliothèque Documents n’est pas destinée à une utilisation générale. Pour plus d’informations, voir Déclarations des fonctionnalités d’application.

Si votre application doit créer et mettre à jour des fichiers que seule votre application utilise, envisagez d’utiliser le dossier LocalCache de l’application. Pour plus d’informations sur les dossiers que vous devez utiliser pour les données de votre application, consultez Classe ApplicationData .

Vous pouvez également laisser l’utilisateur sélectionner l’emplacement du fichier à l’aide d’un sélecteur de fichiers. Pour plus d’informations, consultez Ouvrir des fichiers et des dossiers avec un sélecteur et en particulier la SuggestedStartLocation propriété qui peut être définie sur DocumentsLibrary. Si l’utilisateur sélectionne la bibliothèque de documents dans le sélecteur, vous n’avez pas besoin d’utiliser cette propriété ni de la fonctionnalité documentsLibrary .

Prérequis

Pour accéder à la bibliothèque Documents sans utiliser de sélecteur, procédez comme suit.

• Dans le manifeste de l’application, spécifiez la fonctionnalité Bibliothèque de documents . Cette fonctionnalité n’est pas visible dans manifeste Designer. Pour ajouter la fonctionnalité Bibliothèque de documents, ouvrez le manifeste de l’application en mode code et modifiez directement le code XML. Vous n’avez pas besoin de cette fonctionnalité si vous utilisez les sélecteurs de fichiers.
• Dans le manifeste de l’application, inscrivez au moins une déclaration d’association de type de fichier. Cette déclaration indique explicitement les types de fichiers (extensions) auxquels votre application souhaite accéder dans la bibliothèque Documents. L’application peut uniquement énumérer, créer ou modifier des fichiers dont les types de fichiers sont déclarés dans le manifeste de l’application. Pour plus d’informations, consultez Gérer l’activation des fichiers. Vous n’avez pas besoin d’ajouter cette déclaration si vous utilisez les sélecteurs de fichiers.

Valeur retournée

Pour utiliser la bibliothèque Documents et son contenu, appelez les méthodes et les propriétés de la classe StorageFolder . Pour plus d’informations générales sur l’utilisation des fichiers et dossiers, consultez Énumérer et interroger des fichiers et dossiers.