Partager via


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

Mise à jour : novembre 2007

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 façon que lorsque vous créez un projet dans Visual Studio et que vous êtes invité à sélectionner un dossier pour l'enregistrer. Dans cet exemple, le nom du dossier est ensuite 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)