Fichiers, dossiers et bibliothèques avec le SDK d’application Windows
Les applications du SDK d’application Windows empaquetées peuvent tirer parti des puissantes API fournies par les espaces de noms Windows.Storage, Windows.Storage.Streams et Windows.Storage.Pickers pour lire et écrire efficacement différents formats de données dans des fichiers, ainsi que gérer des fichiers et des dossiers. Cette section traite de sujets essentiels tels que la lecture et l’écriture de paramètres d’application, de sélecteurs de fichiers et de dossiers, et l’accès à des emplacements spéciaux comme la bibliothèque de musique/vidéos. Découvrez comment optimiser les fonctionnalités de gestion des fichiers de votre application avec le SDK d’application Windows.
Windows 10 et versions ultérieures fournissent une grande variété d’API liées aux fichiers, dossiers, bibliothèques et paramètres pour les applications. Ces fonctionnalités sont disponibles via une combinaison d’API WinRT et .NET fournies par le kit SDK Windows et le kit SDK .NET.
Lire et écrire des données avec les API de stockage WinRT
Les applications empaquetées ont accès à toutes les API de stockage WinRT disponibles pour les applications UWP. Que vous migriez une application UWP existante ou créiez une nouvelle application, vous pouvez utiliser ces API pour lire et écrire des données. Pour obtenir des exemples d’utilisation des API de stockage dans une application WinUI, consultez Accéder aux fichiers et dossiers avec le SDK d’application Windows et les API WinRT.
Lire et écrire des données avec des API de fichiers .NET
En plus des API WinRT, les applications empaquetées peuvent utiliser les API .NET de l’espace de noms System.IO pour lire et écrire des données. Lorsqu’un projet WinUI 3 est créé, son fichier Package.appxmanifest contient le paramètre suivant :
<Capabilities>
<rescap:Capability Name="runFullTrust" />
</Capabilities>
La déclaration de cette fonctionnalité restreinte offre un accès complet au système de fichiers, au Registre et à d’autres fonctionnalités restreintes. Pour plus d’informations, consultez Déclarations de fonctionnalités restreintes. En d’autres termes, l’application a le même accès au système de fichiers que toute autre application de bureau .NET lors de l’utilisation des API de fichiers .NET.
Pour obtenir des exemples d’utilisation des API .NET dans une application WinUI, consultez Accéder aux fichiers et dossiers avec le SDK d’application Windows et les API .NET.
Ressources supplémentaires pour l’utilisation de fichiers et de dossiers
Si vous développez des applications WinUI empaquetées, les API de stockage WinRT peuvent être un outil puissant pour lire et écrire des données. Les rubriques UWP suivantes fournissent une mine d’informations aux développeurs qui cherchent à tirer parti de ces API dans leurs applications.
| Sujet | Description |
|---|---|
| Énumérer et interroger des fichiers et dossiers | Accédez aux fichiers et dossiers dans un dossier, une bibliothèque, un appareil ou un emplacement réseau. Vous pouvez également interroger les fichiers et dossiers situés dans un emplacement en créant des requêtes de fichiers et de dossiers. |
| Créer, écrire et lire un fichier | Lisez et écrivez un fichier à l’aide d’un objet StorageFile. |
| Bonnes pratiques concernant l’écriture de données dans des fichiers | Découvrez les bonnes pratiques relatives aux différentes méthodes d’écriture dans les fichier pour les classes FileIO et PathIO. |
| Obtenir les propriétés d’un fichier | Obtenez les propriétés (de haut niveau, de base et étendues) d’un fichier représenté par un objet StorageFile. |
| Ouvrir des fichiers et des dossiers à l’aide d’un sélecteur | Accédez aux fichiers et dossiers en permettant à l’utilisateur d’interagir avec ceux-ci à l’aide d’un sélecteur. Vous pouvez utiliser FolderPicker pour accéder à un dossier. REMARQUE : dans une application de bureau (qui inclut des applications WinUI 3), vous pouvez utiliser des sélecteurs de fichiers et de dossiers à partir de Windows.Storage.Pickers. Toutefois, si l’application de bureau nécessite une élévation pour s’exécuter, vous devrez adopter une approche différente, car ces API ne sont pas conçues pour être utilisées dans une application avec élévation de privilèges. Pour obtenir un exemple, consultez FileSavePicker. |
| Enregistrer un fichier avec un sélecteur | Utilisez FileSavePicker pour permettre aux utilisateurs de spécifier le nom et l’emplacement où ils souhaitent que votre application enregistre un fichier. |
| Accès au contenu Groupement résidentiel | Accédez au contenu stocké dans le dossier Groupement résidentiel de l’utilisateur, qui contient des images, de la musique et des vidéos. |
| Détermination de la disponibilité des fichiers Microsoft OneDrive | Déterminez si un fichier Microsoft OneDrive est disponible à l’aide de la propriété StorageFile.IsAvailable. |
| Fichiers et dossiers des bibliothèques Musique, Images et Vidéos | Ajoutez les dossiers existants de musique, images ou vidéos dans les bibliothèques correspondantes. Vous pouvez également supprimer des dossiers de bibliothèques, obtenir la liste des dossiers d’une bibliothèque et découvrir des photos, de la musique et des vidéos. |
| Suivre les fichiers et dossiers récemment utilisés | Effectuez le suivi des fichiers auxquels l’utilisateur accède fréquemment en les ajoutant à la liste Utilisés récemment de votre application. La plateforme gère les éléments récents pour vous, en les triant selon le critère du dernier accès, et en supprimant l’élément le plus ancien quand la limite de 25 éléments est atteinte. Toutes les applications ont leurs propres éléments utilisés récemment. |
| Suivre les modifications du système de fichiers en arrière-plan | Suivez les changements apportés au système de fichiers, même quand l’application n’est pas en cours d’exécution. |
| Accéder à la carte SD | Vous pouvez stocker des données non essentielles et y accéder sur une carte microSD en option, plus particulièrement sur les appareils mobiles à faible coût dont le stockage interne est limité. |
| Accès rapide aux propriétés de fichier | Rassemblez efficacement une liste de fichiers et leurs propriétés à partir d’une bibliothèque à utiliser par le biais des API Windows Runtime. |
Voir aussi
Accéder aux fichiers et dossiers avec le SDK d’application Windows et les API WinRT
Accéder aux fichiers et dossiers avec le SDK d’application Windows et les API .NET
Windows developer