Comment : sélectionner des dossiers avec le composant FolderBrowserDialog Windows Forms

Dans les applications Windows que vous créez, vous êtes souvent amené à inviter l'utilisateur à sélectionner un dossier, le plus souvent pour enregistrer des fichiers. Le composant FolderBrowserDialog Windows Forms vous permet d'effectuer cette tâche rapidement.

Pour sélectionner des dossiers avec le composant FolderBrowserDialog

1. Dans une procédure, examinez la propriété FolderBrowserDialog du composant DialogResult afin de déterminer comment la boîte de dialogue a été fermée et afin d'obtenir la valeur de la propriété SelectedPath du composant FolderBrowserDialog.

2. Si vous devez définir le dossier de niveau le plus élevé qui apparaît dans l'arborescence de la boîte de dialogue, définissez la propriété RootFolder, qui utilise un membre de l'énumération SpecialFolder.

3. Vous pouvez également définir la propriété Description, qui précise la chaîne de texte qui apparaît au sommet de l'arborescence des dossiers.

   Dans l'exemple ci-dessous, le composant FolderBrowserDialog est utilisé pour sélectionner un dossier, de la même manière que lorsque vous créez un projet dans Visual Studio et êtes invité à sélectionner un dossier dans lequel l'enregistrer. Dans cet exemple, le nom du dossier est affiché dans un contrôle TextBox sur le formulaire. Il est judicieux d'affecter à l'emplacement une zone modifiable, par exemple un contrôle TextBox, afin que l'utilisateur puisse modifier sa sélection en cas d'erreur ou autre problème. Cet exemple illustre un formulaire avec un composant FolderBrowserDialog et un contrôle TextBox.

   Public Sub ChooseFolder()
       If FolderBrowserDialog1.ShowDialog() = DialogResult.OK Then
           TextBox1.Text = FolderBrowserDialog1.SelectedPath
       End If
   End Sub
   

   public void ChooseFolder()
   {
       if (folderBrowserDialog1.ShowDialog() == DialogResult.OK) 
       {
           textBox1.Text = folderBrowserDialog1.SelectedPath;
       }
   }
   

   public:
      void ChooseFolder()
      {
         if (folderBrowserDialog1->ShowDialog() == DialogResult::OK)
         {
            textBox1->Text = folderBrowserDialog1->SelectedPath;
         }
      }
   

   Note de sécurité

   Pour utiliser cette classe, votre assembly nécessite un niveau de privilège accordé par la propriété FileIOPermissionAttribute.PathDiscoveryProperty, qui fait partie de l'énumération FileIOPermissionAccess. Si vous exécutez le programme dans un contexte partiellement fiable, le processus peut lever une exception en raison de privilèges insuffisants. Pour plus d'informations, consultez Notions fondamentales de la sécurité d'accès du code.

Pour plus d'informations sur l'enregistrement de fichiers, consultez Comment : enregistrer des fichiers à l'aide du composant SaveFileDialog.

Voir aussi

Référence

Vue d'ensemble du composant FolderBrowserDialog (Windows Forms)

FolderBrowserDialog

Autres ressources

FolderBrowserDialog, composant (Windows Forms)