Langage: HTML | XAML

Démarrage rapide : accès aux fichiers à l’aide de sélecteurs de fichiers (XAML)

Applies to Windows and Windows Phone

Accédez aux fichiers et dossiers via le sélecteur de fichiers en permettant aux utilisateurs de choisir des fichiers et des dossiers. Vous pouvez utiliser la classe FileOpenPicker pour accéder aux fichiers et FolderPicker pour accéder aux dossiers.

Prérequis

Comprendre la programmation asynchrone pour les applications Windows Runtime en C++, C# ou Visual Basic

Vous pouvez apprendre à écrire des applications asynchrones dans Démarrage rapide : utilisation de l’opérateur await pour la programmation asynchrone.

interface utilisateur de sélecteur de fichiers

Les sélecteurs de fichiers ont des zones en haut et en bas de l’écran qui affichent des informations. Celles-ci permettent aux utilisateurs de s’orienter et leur fournissent une expérience cohérente quand ils accèdent aux fichiers ou les enregistrent.

Les informations affichées incluent les éléments suivants :

  • emplacement actuel, situé dans le coin supérieur gauche ;
  • panier des articles choisis par l’utilisateur, en bas ;
  • Liste déroulante des emplacements que l’utilisateur peut parcourir. Cette liste est sélectionnable à partir du symbole d’accent circonflexe vers le bas situé en haut à gauche.

Par exemple, cette capture d’écran montre un sélecteur de fichiers appelé par une application de messagerie électronique et qui permet à l’utilisateur de choisir des photos (bien que l’utilisateur n’ait pris aucune photo dans la capture d’écran).

Capture d’écran d’un sélecteur de fichiers dans lequel deux fichiers sont sélectionnés pour ouverture.

L’utilisateur peut voir la liste déroulante des emplacements disponibles (par exemple la liste affichée dans la capture d’écran sur la droite) en sélectionnant le symbole d’accent circonflexe vers le bas situé en haut à gauche du sélecteur de fichiers. Ces emplacements incluent ceux du système de fichiers, comme le dossier Musique ou Téléchargements. Ils incluent également d’autres applications, si celles-ci (comme Microsoft OneDrive) participent à des contrats de sélecteurs de fichiers, que vous pouvez voir au bas de la liste dans la capture d’écran.

Capture d’écran rognée du sélecteur de fichiers affichant en haut à gauche la liste déroulante des emplacements.

 

Fonctionnement des sélecteurs de fichiers

Via le sélecteur de fichiers, votre application peut accéder aux fichiers et aux dossiers sur l’ensemble du système de l’utilisateur. Lorsque vous appelez le sélecteur de fichiers, l’utilisateur peut parcourir son système et sélectionner les fichiers (ou dossiers) à accéder et enregistrer. Lorsque l’utilisateur sélectionne des fichiers ou des dossiers, votre application reçoit ces sélections sous forme d’objets StorageFile et StorageFolder. Votre application peut alors œuvrer sur ces fichiers et dossiers sélectionnés à l’aide de ces objets. Pour en savoir plus sur l’accès aux fichiers, voir Accès aux fichiers et autorisations.

Le sélecteur de fichiers utilise une interface unique et unifiée permettant à l’utilisateur de sélectionner des fichiers et des dossiers du système de fichiers ou d’autres applications. Les fichiers sélectionnés d’autres applications sont comme des fichiers du système de fichiers : ils sont renvoyés sous forme d’objets StorageFile. En règle générale, votre application peut travailler sur ces fichiers de la même manière que sur les autres objets de ce type. D’autres applications rendent les fichiers disponibles en participant à des contrats de sélecteurs de fichiers. Si vous estimez que vous pouvez souhaiter que votre application fournisse des fichiers par l’intermédiaire du sélecteur de fichiers, consultez au besoin Intégration aux contrats du sélecteur de fichiers.

Par exemple, vous pouvez appeler le sélecteur de fichiers dans votre application de sorte que votre utilisateur puisse ouvrir un fichier. Cela fait de votre application l’application d’appel. Le sélecteur de fichiers interagit avec le système et les autres applications pour permettre à l’utilisateur de naviguer et de sélectionner le fichier. Lorsque l’utilisateur choisit un fichier, le sélecteur de fichiers retourne ce dernier à votre application. Le diagramme illustre ce processus pour le cas où l’utilisateur choisit un fichier à partir d’une autre application comme OneDrive. Dans ce cas, OneDrive est l’application fournisseuse.

Diagramme illustrant le processus au cours duquel une application obtient un fichier à ouvrir à partir d’une autre application en utilisant le sélecteur de fichiers en tant qu’interface entre les deux applications.

Code complet pour sélectionner un fichier

L’exemple du sélecteur de fichiers montre comment utiliser FileOpenPicker pour permettre à l’utilisateur de sélectionner un fichier donné.


FileOpenPicker openPicker = new FileOpenPicker();
openPicker.ViewMode = PickerViewMode.Thumbnail;
openPicker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;
openPicker.FileTypeFilter.Add(".jpg");
openPicker.FileTypeFilter.Add(".jpeg");
openPicker.FileTypeFilter.Add(".png");

StorageFile file = await openPicker.PickSingleFileAsync();
if (file != null)
{
    // Application now has read/write access to the picked file
    OutputTextBlock.Text = "Picked photo: " + file.Name;
}
else
{
    OutputTextBlock.Text = "Operation cancelled.";
}


Pour le code complet permettant de sélectionner plusieurs fichiers, voir l’exemple de sélecteur de fichiers.

L’exemple de sélecteur de fichiers montre également comment écrire une méthode EnsureUnsnapped.


internal bool EnsureUnsnapped()
{
    // FilePicker APIs will not work if the application is in a snapped state.
    // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
    bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
    if (!unsnapped)
    {
        NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
    }

    return unsnapped;
}


Nous utilisons la méthode EnsureUnsnapped chaque fois que nous essayons d’appeler un sélecteur de fichiers pour nous assurer que l’exemple d’application sera capable de montrer le sélecteur de fichiers. Vous voyez EnsureUnsnapped utilisé dans différents exemples de cette page et vous le voyez en contexte dans le fichier Constants.cs de l’exemple de sélecteur de fichiers.

Avertissement  Si vous essayez d’afficher le sélecteur de fichiers lorsque votre application est ancrée, le sélecteur de fichiers ne s’affichera pas et une exception sera levée. Vous pouvez éviter ce problème en vérifiant que votre application n’est pas ancrée et en la désancrant avant d’appeler le sélecteur de fichiers. Les exemples de code suivant et l’exemple de sélecteur de fichiers vous montrent comment procéder.

Procédure pas à pas pour sélectionner un fichier

Appeler le sélecteur de fichiers passe par trois tâches de base : vérifier que le sélecteur puisse être appelé, créer et personnaliser un objet sélecteur de fichiers, et montrer le sélecteur pour que l’utilisateur puisse sélectionner un ou plusieurs éléments.

  1. Vérifiez que vous pouvez appeler le sélecteur de fichiers

    Chaque fois que vous voulez appeler un sélecteur de fichiers, vous devez d’abord veiller à ce que votre application puisse le montrer. Pour ce faire, vérifiez que votre application n’est pas ancrée ou, si tel est le cas, qu’elle peut sortir de cet état pour montrer le sélecteur de fichiers.

    L’exemple de sélecteur de fichiers montre comment créer une méthode qui vérifiera la ApplicationView.Value de l’application et essaiera de se désancrer avant que l’exemple essaie de créer et de montrer un sélecteur de fichiers.

    
    internal bool EnsureUnsnapped()
    {
        // FilePicker APIs will not work if the application is in a snapped state.
        // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
        bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
        if (!unsnapped)
        {
            NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
        }
    
        return unsnapped;
    }
    
    
    

    Vous devez utiliser cette méthode pour vérifier que vous pouvez appeler un sélecteur de fichiers comme ceci :

    
    if (MainPage.Current.EnsureUnsnapped())
    {
        // Code to call file picker
    }
    
    

    Nous utilisons la méthode EnsureUnsnapped chaque fois que nous essayons d’appeler un sélecteur de fichiers pour nous assurer que l’exemple d’application sera capable de montrer le sélecteur de fichiers. Vous voyez EnsureUnsnapped utilisé dans différents exemples de cette page et vous le voyez en contexte dans le fichier Constants.cs de l’exemple de sélecteur de fichiers.

    Avertissement  Si vous essayez d’afficher le sélecteur de fichiers lorsque votre application est ancrée, l’appel échouera et vous rencontrerez une exception.

  2. Créer et personnaliser un FileOpenPicker

    Utilisez FileOpenPicker si l’utilisateur sélectionne des fichiers. Vous pouvez personnaliser cette classe en définissant des propriétés sur l’objet que vous créez.

    L’exemple du sélecteur de fichiers montre comment créer et personnaliser un objet FileOpenPicker.

    
    FileOpenPicker openPicker = new FileOpenPicker();
    openPicker.ViewMode = PickerViewMode.Thumbnail;
    openPicker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;
    openPicker.FileTypeFilter.Add(".jpg");
    openPicker.FileTypeFilter.Add(".jpeg");
    openPicker.FileTypeFilter.Add(".png");
    
    
    

    Sur l’objet sélecteur de fichiers, définissez les propriétés qui sont pertinentes pour vos utilisateurs et votre application. Pour obtenir des directives susceptibles de vous aider à choisir comment personnaliser le sélecteur de fichiers, voir Recommandations et liste de vérification sur les sélecteurs de fichiers. Pour des explications sur les raisons pour lesquelles nous définissons certaines propriétés pour personnaliser les sélecteurs de fichiers dans l’exemple de sélecteur de fichiers, poursuivez la lecture.

    Personnalisations de l’exemple de sélecteur de fichiers FileOpenPicker, explications

    L’exemple de sélecteur de fichiers crée un éventail visuel riche d’images dans un emplacement pratique où l’utilisateur peut faire son choix en définissant trois propriétés FileOpenPicker : ViewMode, SuggestedStartLocation et FileTypeFilter.

    • Définir openPicker.ViewMode à la valeur enum Thumbnail PickerViewMode crée un éventail visuel riche utilisant des images miniatures pour représenter les fichiers dans le sélecteur de fichiers.

      
      openPicker.ViewMode = PickerViewMode.Thumbnail;
      
      

      Envisagez de définir ViewMode à PickerViewMode.Thumbnail si vous utilisez le sélecteur de fichiers pour afficher des fichiers visuels comme des images ou des vidéos. Autrement, utilisez PickerViewMode.List.

      Dans certains cas, l’utilisateur peut souhaiter sélectionner une image ou une vidéo, ou tout autre type de fichier. Par exemple, l’utilisateur peut sélectionner un fichier à joindre à un message électronique ou à envoyer par messagerie instantanée. Dans ce cas, prenez en charge les deux modes d’affichage en ajoutant deux contrôles d’interface utilisateur à votre application. Un contrôle doit appeler le sélecteur de fichiers en utilisant le mode d’affichage Thumbnail, de sorte que l’utilisateur puisse sélectionner des images et des vidéos. L’autre contrôle doit appeler le sélecteur de fichiers en utilisant le mode d’affichage List, de sorte que l’utilisateur puisse sélectionner d’autres types de fichiers. Par exemple, une application de messagerie aura deux boutons : Joindre une image ou une vidéo et Joindre un document.

    • Définir openPicker.SuggestedStartLocation sur Images avec PickerLocationId.PicturesLibrary permet à l’utilisateur de démarrer à un emplacement où il est susceptible de trouver des images.

      
      openPicker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;
      
      

      Définissez SuggestedStartLocation sur un emplacement du système de fichiers approprié au type de fichier sélectionné. Si l’utilisateur sélectionne de la musique, des images ou des vidéos, définissez respectivement l’emplacement de départ sur Musique, Images ou Vidéos. Pour tous les autres types de fichiers, définissez l’emplacement de départ sur Documents. Il s’agit juste d’un emplacement de départ. Les utilisateurs peuvent naviguer vers d’autres emplacements tant qu’ils utilisent le sélecteur de fichiers.

      De plus, le SuggestedStartLocation n’est pas toujours utilisé comme emplacement de départ pour le sélecteur de fichiers. Pour donner à l’utilisateur une impression de cohérence, le sélecteur de fichiers se souvient du dernier emplacement que l’utilisateur a consulté et l’utilisera généralement comme emplacement de départ.

    • Utiliser openPicker.FileTypeFilter.Add pour spécifier les types des fichiers que l’utilisateur peut voir dans le sélecteur de fichiers nous permet de veiller à ce que l’utilisateur reste concentré sur la sélection de fichiers pertinents et utilisables.

      
      openPicker.FileTypeFilter.Add(".jpg");
      openPicker.FileTypeFilter.Add(".jpeg");
      openPicker.FileTypeFilter.Add(".png");
      
      

      Pour C#:  Add est le nom de la méthode Append pour les développeurs C#.

      Vous devez envisager de spécifier les types de fichiers à afficher dans le sélecteur de fichiers pour veiller à ce que les fichiers affichés soient pertinents. Par exemple, si votre application est un lecteur vidéo, vous pouvez utiliser la propriété FileTypeFilter pour veiller à ce que les fichiers affichés dans le sélecteur de fichiers soient dans des formats vidéo pris en charge par votre lecteur, d’après leurs extensions de nom de fichier.

      Si vous souhaitez remplacer d’anciens types de fichiers dans FileTypeFilter par de nouvelles entrées, vous pouvez utiliser la méthode ReplaceAll à la place de la méthode Add.

  3. Montrer le FileOpenPicker

    Vous pouvez maintenant montrer le sélecteur de fichiers pour que l’utilisateur puisse sélectionner un ou plusieurs fichiers :

    • Montrer pour que l’utilisateur puisse sélectionner un fichier

      Une fois que vous avez créé et personnalisé un sélecteur de fichiers, offrez à l’utilisateur la possibilité de choisir un fichier en appelant await sur FileOpenPicker.PickSingleFileAsync.

      Quand l’utilisateur choisit un fichier, FileOpenPicker.PickSingleFileAsync retourne un objet StorageFile qui représente le fichier choisi.

      L’exemple du sélecteur de fichiers montre comment afficher le sélecteur pour permettre à l’utilisateur de choisir un fichier.

      
      StorageFile file = await openPicker.PickSingleFileAsync();
      if (file != null)
      {
          // Application now has read/write access to the picked file
          OutputTextBlock.Text = "Picked photo: " + file.Name;
      }
      else
      {
          OutputTextBlock.Text = "Operation cancelled.";
      }
      
      
      
    • Montrer pour que l’utilisateur puisse sélectionner plusieurs fichiers

      Une fois que vous avez créé et personnalisé un sélecteur de fichiers, offrez la possibilité à l’utilisateur de choisir plusieurs fichiers en appelant await sur FileOpenPicker.PickMultipleFilesAsync.

      Si l’utilisateur sélectionne plusieurs fichiers, FileOpenPicker.PickMultipleFilesAsync renvoie une liste de fichiers sélectionnés. Les fichiers de la liste sont représentés par des objets StorageFile.

      L’exemple du sélecteur de fichiers montre comment afficher le sélecteur pour permettre à l’utilisateur de sélectionner plusieurs fichiers, et comment capturer la liste des fichiers sélectionnés en vue de leur traitement.

      
      IReadOnlyList<StorageFile> files = await openPicker.PickMultipleFilesAsync();
      if (files.Count > 0)
      {
          StringBuilder output = new StringBuilder("Picked files:\n");
          // Application now has read/write access to the picked file(s)
          foreach (StorageFile file in files)
          {
              output.Append(file.Name + "\n");
          }
          OutputTextBlock.Text = output.ToString();
      }
      else
      {
          OutputTextBlock.Text = "Operation cancelled.";
      }
      
      
      

Code complet pour sélectionner un dossier

L’exemple du sélecteur de fichiers montre comment utiliser FolderPicker pour permettre à l’utilisateur de sélectionner un fichier donné.


if (rootPage.EnsureUnsnapped())
{
    FolderPicker folderPicker = new FolderPicker();
    folderPicker.SuggestedStartLocation = PickerLocationId.Desktop;
    folderPicker.FileTypeFilter.Add(".docx");
    folderPicker.FileTypeFilter.Add(".xlsx");
    folderPicker.FileTypeFilter.Add(".pptx");

    StorageFolder folder = await folderPicker.PickSingleFolderAsync();
    if (folder != null)
    {
        // Application now has read/write access to all contents in the picked folder (including other sub-folder contents)
        StorageApplicationPermissions.FutureAccessList.AddOrReplace("PickedFolderToken", folder);
        OutputTextBlock.Text = "Picked folder: " + folder.Name;
    }
    else
    {
        OutputTextBlock.Text = "Operation cancelled.";
    }
}


Pour le code complet permettant de sélectionner plusieurs fichiers, voir l’exemple de sélecteur de fichiers.

L’exemple de sélecteur de fichiers montre également comment écrire une méthode EnsureUnsnapped.


internal bool EnsureUnsnapped()
{
    // FilePicker APIs will not work if the application is in a snapped state.
    // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
    bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
    if (!unsnapped)
    {
        NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
    }

    return unsnapped;
}


Nous utilisons la méthode EnsureUnsnapped chaque fois que nous essayons d’appeler un sélecteur de fichiers pour nous assurer que l’exemple d’application sera capable de montrer le sélecteur de fichiers. Vous voyez EnsureUnsnapped utilisé dans différents exemples de cette page et vous le voyez en contexte dans le fichier Constants.cs de l’exemple de sélecteur de fichiers.

Avertissement  Si vous essayez d’afficher le sélecteur de fichiers lorsque votre application est ancrée, le sélecteur de fichiers ne s’affichera pas et une exception sera levée. Vous pouvez éviter ce problème en vérifiant que votre application n’est pas ancrée et en la désancrant avant d’appeler le sélecteur de fichiers. Les exemples de code suivant et l’exemple de sélecteur de fichiers vous montrent comment procéder.

Procédure pas à pas pour sélectionner un dossier

Appeler le sélecteur de fichiers passe par trois tâches de base : vérifier que le sélecteur puisse être appelé, créer et personnaliser un objet sélecteur de fichiers et montrer le sélecteur pour que l’utilisateur puisse sélectionner un ou plusieurs éléments.

  1. Vérifiez que vous pouvez appeler le sélecteur de fichiers

    Chaque fois que vous voulez appeler un sélecteur de fichiers, vous devez d’abord veiller à ce que votre application puisse le montrer. Pour ce faire, vérifiez que votre application n’est pas ancrée ou, si tel est le cas, qu’elle peut sortir de cet état pour montrer le sélecteur de fichiers.

    L’exemple de sélecteur de fichiers montre comment créer une méthode qui vérifiera la ApplicationView.Value de l’application et essaiera de se désancrer avant que l’exemple essaie de créer et de montrer un sélecteur de fichiers.

    
    internal bool EnsureUnsnapped()
    {
        // FilePicker APIs will not work if the application is in a snapped state.
        // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
        bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
        if (!unsnapped)
        {
            NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
        }
    
        return unsnapped;
    }
    
    
    

    Vous devez utiliser cette méthode pour vérifier que vous pouvez appeler un sélecteur de fichiers comme ceci :

    
    if (MainPage.Current.EnsureUnsnapped())
    {
        // Code to call file picker
    }
    
    

    Nous utilisons la méthode EnsureUnsnapped chaque fois que nous essayons d’appeler un sélecteur de fichiers pour nous assurer que l’exemple d’application sera capable de montrer le sélecteur de fichiers. Vous voyez EnsureUnsnapped utilisé dans différents exemples de cette page et vous le voyez en contexte dans le fichier Constants.cs de l’exemple de sélecteur de fichiers.

    Avertissement  Si vous essayez d’afficher le sélecteur de fichiers lorsque votre application est ancrée, l’appel échouera et vous rencontrerez une exception.

  2. Créer et personnaliser un FolderPicker

    Utilisez FolderPicker si l’utilisateur sélectionne un dossier. Vous pouvez personnaliser cette classe en définissant des propriétés sur l’objet que vous créez.

    L’exemple du sélecteur de fichiers montre comment créer et personnaliser un objet FolderPicker.

    
    FolderPicker folderPicker = new FolderPicker();
    folderPicker.SuggestedStartLocation = PickerLocationId.Desktop;
    folderPicker.FileTypeFilter.Add(".docx");
    folderPicker.FileTypeFilter.Add(".xlsx");
    folderPicker.FileTypeFilter.Add(".pptx");
    
    
    

    Sur l’objet sélecteur de fichiers, définissez les propriétés qui sont pertinentes pour vos utilisateurs et votre application. Pour obtenir des directives susceptibles de vous aider à choisir comment personnaliser le sélecteur de fichiers, voir Recommandations et liste de vérification sur les sélecteurs de fichiers. Pour des explications sur les raisons pour lesquelles nous définissons certaines propriétés pour personnaliser les sélecteurs de fichiers dans l’exemple de sélecteur de fichiers, poursuivez la lecture.

    Personnalisations de l’exemple de sélecteur de fichiers FolderPicker, explications

    L’exemple de sélecteur de fichiers personnalise un sélecteur de fichiers en sélecteur de dossiers à l’aide de trois propriétés FolderPicker : ViewMode, SuggestedStartLocation et FileTypeFilter.

    • Utiliser l’objet PickerViewMode.List par défaut pour folderPicker.ViewMode nous permet de créer un affichage en forme de liste dans le sélecteur. Cette liste est parfaite pour sélectionner les fichiers qui ne sont pas très visuels, comme les documents.

      Envisagez de définir ViewMode à PickerViewMode.Thumbnail si vous utilisez le sélecteur de fichiers pour afficher des fichiers visuels comme des images ou des vidéos. Autrement, utilisez PickerViewMode.List.

      Si vous affichez des fichiers visuels comme des images ou des vidéos, définissez folderPicker.ViewMode à Thumbnail comme ceci :

      
      folderPicker.ViewMode = PickerViewMode.Thumbnail;
      
      
    • Définir folderPicker.SuggestedStartLocation au bureau de l’utilisateur avec PickerLocationId.Desktop permet à l’utilisateur de démarrer à un emplacement familier et fréquemment utilisé.

      
      folderPicker.SuggestedStartLocation = PickerLocationId.Desktop;
      
      

      Définissez SuggestedStartLocation à un emplacement du système de fichiers qui soit approprié pour le type de dossier que l’utilisateur souhaite sélectionner. Par exemple, si l’utilisateur sélectionne un dossier contenant des fichiers musicaux, faites en sorte qu’il démarre dans Musique. Il s’agit juste de l’emplacement de départ. Les utilisateurs peuvent naviguer vers d’autres emplacements tant qu’ils utilisent le sélecteur de fichiers.

      De plus, le SuggestedStartLocation n’est pas toujours utilisé comme emplacement de départ pour le sélecteur de fichiers. Pour donner à l’utilisateur une impression de cohérence, le sélecteur de fichiers se souvient du dernier emplacement que l’utilisateur a consulté et l’utilisera généralement comme emplacement de départ.

    • Utiliser folderPicker.FileTypeFilter.Add pour spécifier les types des fichiers que l’utilisateur peut voir dans le sélecteur de fichiers nous permet de veiller à ce que l’utilisateur reste concentré sur la sélection d’un dossier pertinent.

      
      folderPicker.FileTypeFilter.Add(".docx");
      folderPicker.FileTypeFilter.Add(".xlsx");
      folderPicker.FileTypeFilter.Add(".pptx");
      
      

      Remarque  Add est la méthode Append telle qu’elle est projetée pour les développeurs C#.

      Un FolderPicker permet aux utilisateurs de sélectionner des dossiers, pas des fichiers individuels. Toutefois, montrer des fichiers pertinents dans le FolderPicker aide les utilisateurs à choisir leur dossier. Par exemple, lorsque vous utilisez le FolderPicker pour sélectionner un emplacement d’où importer des images, montrer les fichiers d’image aide l’utilisateur à identifier les éléments qui seront importés lorsque l’emplacement sera sélectionné.

  3. Montrer le FolderPicker pour que l’utilisateur puisse sélectionner un dossier

    Une fois que vous avez créé et personnalisé un FolderPicker, offrez à l’utilisateur la possibilité de choisir un fichier en appelant await sur FolderPicker.PickSingleFolderAsync.

    Quand l’utilisateur sélectionne un fichier, FolderPicker.PickSingleFolderAsync renvoie un objet StorageFolder qui représente le dossier sélectionné.

    L’exemple du sélecteur de fichiers montre comment afficher le sélecteur pour permettre à l’utilisateur de sélectionner un dossier, et comment capturer ce dossier en vue de son traitement.

    
    StorageFolder folder = await folderPicker.PickSingleFolderAsync();
    if (folder != null)
    {
        // Application now has read/write access to all contents in the picked folder (including other sub-folder contents)
        StorageApplicationPermissions.FutureAccessList.AddOrReplace("PickedFolderToken", folder);
        OutputTextBlock.Text = "Picked folder: " + folder.Name;
    }
    else
    {
        OutputTextBlock.Text = "Operation cancelled.";
    }
    
    
    

Récapitulatif et étapes suivantes

Si votre code ressemble à ce qui est montré ici, votre application ouvre un sélecteur de fichiers qui permet aux utilisateurs de sélectionner un ou plusieurs fichiers ou dossiers que votre application peut ensuite ouvrir.

Astuce  Chaque fois que votre application accède à un fichier ou un dossier via le sélecteur de fichiers, ajoutez cet élément à la FutureAccessList ou à la MostRecentlyUsedList de votre application pour en garder la trace. Pour plus d’informations sur l’utilisation de ces listes, voir Comment suivre les fichiers et les dossiers récemment utilisés.

Pour en savoir plus sur la lecture et l’écriture des fichiers, voir Démarrage rapide : lecture et écriture d’un fichier et l’exemple d’accès au fichier. Pour apprendre à travailler avec des fichiers d’image, voir Démarrage rapide : Image et ImageBrush, Démarrage rapide : création d’images et l’exemple d’image XAML.

Pour apprendre à appeler le sélecteur de fichiers afin d’enregistrer des fichiers, voir Comment enregistrer des fichiers via les sélecteurs de fichiers.

Pour que votre application indique des fichiers, un emplacement d’enregistrement ou des mises à jour de fichiers aux autres applications, voir Démarrage rapide : intégration aux contrats du sélecteur de fichiers.

Rubriques associées

Exemple de sélecteur de fichiers
Exemple d’accès aux fichiers
Exemple d’image XAML
Recommandations et liste de vérification sur les sélecteurs de fichiers
Comment enregistrer des fichiers via les sélecteurs de fichiers
Comment suivre les fichiers et les dossiers récemment utilisés
Démarrage rapide : lecture et écriture d’un fichier
Démarrage rapide : Image et ImageBrush
Démarrage rapide : création d’images
Accès aux fichiers et autorisations
Démarrage rapide : intégration aux contrats du sélecteur de fichiers
Référence d’espace de noms
Windows.Storage.Pickers namespace
Windows.Storage.Pickers.FileOpenPicker class
Windows.Storage.Pickers.FolderPicker class
Windows.Storage.Pickers.PickerLocationId enum
Windows.Storage.Pickers.PickerViewMode enum

 

 

Afficher:
© 2014 Microsoft