DownloadsFolder Classe

Définition

Espace de noms:

Windows.Storage

Crée des fichiers et des dossiers dans le dossier Téléchargements.

public ref class DownloadsFolder abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class DownloadsFolder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class DownloadsFolder

Public Class DownloadsFolder

Héritage

Object Platform::Object IInspectable DownloadsFolder

Attributs

ContractVersionAttribute

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

Vous pouvez créer un fichier vide dans le dossier Téléchargements comme suit :

StorageFile file = await Windows.Storage.DownloadsFolder.CreateFileAsync("sample.txt");
// Process file

Une fois createFileAsync terminé, file obtient le nouveau fichier en tant que StorageFile.

Remarques

Cette classe est statique et ne peut pas être instanciée. Appelez les méthodes directement à la place.

Autorisations de fichier et de dossier dans le dossier Téléchargements

Toutes les applications peuvent créer des fichiers et des dossiers dans le dossier Téléchargements et accéder aux fichiers qu’elles créent. Toutefois, les applications ne peuvent pas accéder aux fichiers du dossier Téléchargements qu’elles n’ont pas créés.

Lorsque votre application crée un fichier dans le dossier Téléchargements, d’autres applications ne peuvent pas interférer avec votre fichier ou y accéder, sauf si l’utilisateur donne explicitement l’accès à l’autre application. L’utilisateur peut accorder à une autre application l’accès à votre fichier en sélectionnant le fichier dans le sélecteur de fichiers. Votre application peut également utiliser le sélecteur de fichiers pour accéder aux fichiers du dossier Téléchargements qu’elle n’a pas créés. En savoir plus sur l’ouverture de fichiers avec le sélecteur de fichiers dans Ouvrir des fichiers et des dossiers avec un sélecteur.

Les fonctionnalités ne sont pas nécessaires pour créer des fichiers ou y accéder dans le dossier Téléchargements. En savoir plus sur les fonctionnalités dans les déclarations de fonctionnalités d’application.

Pour en savoir plus sur les emplacements accessibles par votre application, consultez Autorisations d’accès aux fichiers.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1511	10586	CreateFileForUserAsync(User,String)
1511	10586	CreateFileForUserAsync(User,String,CreationCollisionOption)
1511	10586	CreateFolderForUserAsync(User,String)
1511	10586	CreateFolderForUserAsync(User,String,CreationCollisionOption)

Méthodes

CreateFileAsync(String)	Crée un fichier dans le dossier Téléchargements.
CreateFileAsync(String, CreationCollisionOption)	Crée un fichier dans le dossier Téléchargements et spécifie la procédure à suivre si un fichier portant le même nom existe déjà dans le dossier Téléchargements.
CreateFileForUserAsync(User, String)	Crée un fichier dans le dossier Téléchargements d’un utilisateur spécifique.
CreateFileForUserAsync(User, String, CreationCollisionOption)	Crée un fichier dans le dossier Téléchargements d’un utilisateur spécifique et spécifie ce qu’il faut faire si un fichier portant le même nom existe déjà dans le dossier Téléchargements.
CreateFolderAsync(String)	Crée un sous-dossier dans le dossier Téléchargements.
CreateFolderAsync(String, CreationCollisionOption)	Crée un sous-dossier dans le dossier Téléchargements et spécifie la procédure à suivre si un sous-dossier portant le même nom existe déjà dans le dossier Téléchargements.
CreateFolderForUserAsync(User, String)	Crée un sous-dossier à l’intérieur du dossier Téléchargements d’un utilisateur spécifique.
CreateFolderForUserAsync(User, String, CreationCollisionOption)	Crée un sous-dossier dans le dossier Téléchargements d’un utilisateur spécifique et spécifie ce qu’il faut faire si un sous-dossier portant le même nom existe déjà dans le dossier Téléchargements.