Partager via

Gérer des fichiers, des dossiers et des bibliothèques avec le Kit de développement logiciel (SDK) d’application Windows

Le Kit de développement logiciel (SDK) d’application Windows fournit des fonctionnalités de gestion de fichiers puissantes pour les applications empaquetées. Vous pouvez utiliser des API à partir des espaces de noms Windows.Storage, Windows.Storage.Streams et Microsoft.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.

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 de SDK d’application Windows, de Windows Runtime (WinRT) et d’API .NET fournies par le SDK d’application Windows, le SDK Windows et le Kit de développement logiciel (SDK) .NET.

Utiliser les sélecteurs du Kit de développement logiciel (SDK) d’application Windows pour lire et écrire des données

Il existe des API de sélecteur disponibles dans le Kit de développement logiciel (SDK) d’application Windows version 1.8 et ultérieure. 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 les sélecteurs de fichiers et de dossiers du Kit de développement logiciel (SDK) d’application Windows pour permettre aux utilisateurs de parcourir et de sélectionner des fichiers ou dossiers dans votre application WinUI. Les API du sélecteur fournissent une expérience Windows familière qui aide les utilisateurs à naviguer dans les emplacements de stockage de leurs appareils et dans le cloud. Découvrez comment permettre aux utilisateurs de sélectionner un fichier ou un dossier à ouvrir à l’aide des classes FileOpenPicker et FolderPicker .
Enregistrer un fichier avec le sélecteur de SDK d’application Windows 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 Kit de développement logiciel (SDK) d’application Windows 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.

Principales différences entre les sélecteurs de SDK WinRT et Windows App

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

  • Contrairement à l’API Windows.Storage.Pickers existante qui retourne des objets StorageFile et StorageFolder, cette nouvelle API retourne des chemins basés sur des chaînes via les classes PickFileResult et PickFolderResult. Cela simplifie l’API et évite les complications liées aux fonctionnalités de stockage 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 exiger que FileTypeFilter ou FileTypeChoices soient spécifiés . 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 du groupe résidentiel a été exclu de la nouvelle énumération 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éder aux données avec des API de stockage WinRT

Les applications empaquetées ont accès à toutes les API de stockage WinRT 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, consultez Les fichiers et dossiers Access avec le SDK d’application Windows et les API WinRT.

Utiliser les API de fichier .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’un projet WinUI 3 est créé, son Package.appxmanifest fichier contient le paramètre suivant :

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

La déclaration de cette fonctionnalité restreinte fournit 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 fichier .NET.

Pour obtenir des exemples d’utilisation des API .NET dans une application WinUI, consultez Les fichiers et dossiers Access 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 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 d’un dossier, d’une bibliothèque, d’un appareil ou d’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 Lire et écrire 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édez 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.
Accéder à la carte SD Vous pouvez stocker et accéder aux données non essentielles sur une carte microSD facultative, en particulier sur les appareils mobiles à faible coût qui ont un stockage interne 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 via les API Windows Runtime.

Voir aussi

Accéder aux fichiers et dossiers avec le SDK d’applications Windows et les API WinRT

Accéder aux fichiers et dossiers avec le Kit de développement logiciel (SDK) d’application Windows et les API .NET

System.IO

  • Last updated on