Gérer des fichiers, des dossiers et des bibliothèques avec Windows App SDK

Windows App SDK fournit des fonctionnalités de gestion de fichiers puissantes pour les applications empaquetées. Vous pouvez utiliser des API à partir du Windows.Storage, Windows.Storage.Streams et Microsoft.Windows.Storage.Pickers espace de noms pour lire et écrire efficacement différents formats de données dans des fichiers, ainsi que gérer des fichiers et des dossiers.

Il existe un large éventail d’API liées aux fichiers, dossiers, bibliothèques et paramètres des applications de bureau Windows à partir de Windows 10. Ces fonctionnalités sont disponibles via une combinaison d’API Windows App SDK, Windows Runtime (WinRT) et .NET fournies par les API Windows App SDK, Windows SDK et .NET SDK.

Utiliser les sélecteurs de Windows App SDK pour lire et écrire des données

Il existe des API de sélecteur disponibles dans les Windows App SDK version 1.8 et ultérieures. Les rubriques suivantes fournissent des informations sur l’utilisation des API sélecteur pour permettre aux utilisateurs d’ouvrir et d’enregistrer des fichiers et des dossiers dans votre application :

Sujet	Descriptif
Ouvrir des fichiers et des dossiers avec des sélecteurs dans WinUI	Utilisez Windows App SDK sélecteurs de fichiers et de dossiers pour permettre aux utilisateurs de parcourir et de sélectionner des fichiers ou dossiers dans votre application WinUI. Les API de sélecteur fournissent une expérience Windows familière qui permet aux utilisateurs de naviguer au sein de leur appareil et de leurs emplacements de stockage cloud. Découvrez comment permettre aux utilisateurs de sélectionner un fichier ou un dossier à ouvrir à l’aide des classes FileOpenPicker et FolderPicker.
Enregistrez un fichier à l'aide du sélecteur de fichiers Windows App SDK dans WinUI	Lors de la création d’applications WinUI et d’autres applications clientes Windows, les utilisateurs doivent souvent enregistrer des fichiers tels que des documents, des images ou d’autres contenus à des emplacements spécifiques sur leur appareil. Le Windows App SDK fournit la classe FileSavePicker pour créer une interface cohérente et conviviale qui permet aux utilisateurs d’enregistrer des fichiers et de les nommer.

Différences clés entre les sélecteurs WinRT et Windows App SDK

Voici quelques différences clés de WinRT Windows.Storage.Pickers utilisés par les applications UWP :

• Contrairement à l'API existante Windows.Storage.Pickers qui renvoie des objets StorageFile et StorageFolder, cette nouvelle API retourne des chemins sous forme de chaînes via les classes PickFileResult et PickFolderResult. Cela simplifie l’API et évite les complications avec les fonctionnalités de storage dans des scénarios élevés.
• De même, la propriété FileSavePicker.SuggestedSaveFile (qui a retourné un StorageFile) a été remplacée. Ses fonctionnalités sont désormais couvertes par deux propriétés de chaîne : SuggestedFolder et SuggestedFileName. Celles-ci vous permettent de suggérer le dossier et le nom du fichier pour la boîte de dialogue d’enregistrement.
• Tous les nouveaux sélecteurs sont conçus spécifiquement pour les applications de bureau et utilisent une propriété WindowId pour lier le sélecteur à sa fenêtre hôte, en remplaçant le WinRT.Interop.InitializeWithWindow.Initialize modèle.
• Les nouveaux sélecteurs permettent aux développeurs de les utiliser sans nécessiter FileTypeFilter ou FileTypeChoices à spécifier. Bien que les sélecteurs UWP lèvent des exceptions lorsque ces propriétés ne sont pas définies, les nouveaux sélecteurs affichent par défaut tous les fichiers lorsque les développeurs ne configurent pas explicitement ces propriétés.
• L’emplacement HomeGroup a été exclu du nouvel emplacement PickerLocationId car il n’est plus pris en charge à partir de Windows 10.
• FolderPicker.FileTypeFilter a été exclu car il n’était pas approprié pour la sélection de dossiers.
• Exclusion des méthodes et des propriétés déjà marquées comme déconseillées ou « Ne pas utiliser ». Par exemple, PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync, etc.
• À l’exception des méthodes et des propriétés pour le mode multi-utilisateur, car les nouvelles API sont actuellement conçues pour les scénarios de bureau où chaque utilisateur possède sa propre session interactive, et chaque session est complètement indépendante des autres sessions sur l’appareil. Contrairement à Xbox ou à d’autres appareils multi-utilisateurs.

Accédez aux données avec les API de stockage WinRT

Les applications empaquetées ont access à toutes les API WinRT storage disponibles pour les applications UWP. Que vous migrez une application UWP existante ou que vous créez une 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 3, consultez Accédez aux fichiers et dossiers avec les API Windows App SDK et WinRT.

Utiliser les API de fichiers .NET pour l'accès aux données

Outre les API WinRT, les applications de bureau empaquetées peuvent utiliser les API .NET dans l’espace de noms System.IO pour lire et écrire des données. Lorsqu’une nouvelle project WinUI est créée, son fichier Package.appxmanifest contient le paramètre suivant :

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

La déclaration de cette capacité restreinte fournit des accès complets au système de fichiers, au registre et à d'autres capacités restreintes. Pour plus d’informations, consultez déclarations de fonctionnalités restreintes. En d’autres termes, l’application a le même access au système de fichiers que toute autre application de bureau .NET lors de l’utilisation des API de fichier .NET.

Pour obtenir des exemples d’utilisation des API .NET dans une application WinUI, consultez accédez aux fichiers et dossiers avec les API du Windows App SDK et .NET.

Ressources supplémentaires pour l’utilisation de fichiers et de dossiers

Si vous développez des applications WinUI empaquetées, les API WinRT storage peuvent être un outil puissant pour lire et écrire des données. Les rubriques UWP suivantes fournissent une multitude d’informations pour les développeurs qui cherchent à tirer parti de ces API dans leurs applications.

Sujet	Descriptif
Énumérer et interroger des fichiers et dossiers	Accédez aux fichiers et dossiers soit dans un dossier, une bibliothèque, un appareil ou un emplacement réseau. Vous pouvez également interroger les fichiers et dossiers dans un emplacement en construisant 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.
Meilleures pratiques pour l’écriture dans des fichiers	Découvrez les meilleures pratiques pour utiliser différentes méthodes d’écriture de fichiers des classes FileIO et PathIO.
Obtenir les propriétés du fichier	Obtenir des propriétés (de niveau supérieur, de base et étendue) pour un fichier représenté par un objet StorageFile.
Accès au contenu du groupe résidentiel	Accéder au contenu stocké dans le dossier HomeGroup de l'utilisateur, y compris les images, la musique et les 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 dans les bibliothèques Musique, Images et Vidéos	Ajoutez des dossiers existants de musique, d’images ou de vidéos aux bibliothèques correspondantes. Vous pouvez également supprimer des dossiers des bibliothèques, obtenir la liste des dossiers d’une bibliothèque et découvrir les photos stockées, la musique et les vidéos.
Suivre les fichiers et dossiers récemment utilisés	Effectuez le suivi des fichiers auxquels votre utilisateur accède fréquemment en les ajoutant à la liste la plus récente utilisée (MRU) de votre application. La plateforme gère l’U MRU pour vous en triant les éléments en fonction de leur dernier accès et en supprimant l’élément le plus ancien lorsque la limite de 25 éléments de la liste est atteinte. Toutes les applications ont leur propre MRU.
Suivre les modifications apportées au système de fichiers en arrière-plan	Suivez les modifications apportées au système de fichiers, même lorsque l’application n’est pas en cours d’exécution.
Access la carte SD	Vous pouvez stocker et accéder à des données non essentielles sur une carte microSD facultative, en particulier sur les appareils mobiles à bas coût qui ont des stockages internes limités.
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 via les API Windows Runtime.

Voir aussi

Accéder aux fichiers et dossiers avec les API Windows App SDK et WinRT

Accédez aux fichiers et dossiers avec les API Windows App SDK et .NET

System.IO