DocumentsLibrary | documentsLibrary, propriété

KnownFolders.DocumentsLibrary | documentsLibrary Property

Obtient la bibliothèque de documents.

Syntaxe


var documentsLibrary = Windows.Storage.KnownFolders.documentsLibrary;

Valeur de propriété

Type: StorageFolder

Bibliothèque Documents.

Remarques

Remarque   Contrairement à d'autres bibliothèques, votre application doit utiliser la déclaration d'association de fichier dans le fichier manifeste d'application pour déclarer explicitement quels types de fichier (extensions) seront consultées ou créés dans la bibliothèque de documents. Cette spécification complète la fonctionnalité Bibliothèque de documents. Pour en savoir plus sur ces fonctionnalités, consultez Accès aux ressources utilisateur à l'aide de Windows Runtime.

Les bibliothèques, un concept introduit dans Windows 7, permettent aux utilisateurs d'afficher le contenu d'utilisateur associé à partir d'un emplacement unique. Comme la bibliothèque est un emplacement virtuel, les dossiers qui sont ajoutés à la bibliothèque ou supprimés de cette dernière continuent également d'exister dans leurs emplacements d'origine. Pour en savoir plus sur les bibliothèques, consultez Bibliothèques Windows.

Windows Phone 8

Cette API n'est pas implémentée et lève une exception si elle est appelée. Consultez API de runtime Windows Phone.

Exemples

L'Exemple d'accès au fichier montre comment utiliser la propriété documentsLibrary pour créer un fichier dans la bibliothèque de documents.


Windows.Storage.KnownFolders.documentsLibrary.createFileAsync("sample.dat", Windows.Storage.CreationCollisionOption.replaceExisting).done(
   function (file) {
       // Process file
   },
   // Handle errors with an error function
   function (error) {
       // Process errors
   }
);

À la fin de l'exécution de createFileAsync, la variable file obtient le nouveau fichier sous la forme d'un storageFile.

Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Téléphone minimal pris en charge

Windows Phone 8 [non implémenté, voir Remarques]

Espace de noms

Windows.Storage
Windows::Storage [C++]

Métadonnées

Windows.winmd

Capabilities

documentsLibrary

Voir aussi

KnownFolders

 

 

Afficher:
© 2017 Microsoft