FileDialog.InitialDirectory Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit le répertoire initial affiché dans la boîte de dialogue de fichier.

public:
 property System::String ^ InitialDirectory { System::String ^ get(); void set(System::String ^ value); };

public string InitialDirectory { get; set; }

member this.InitialDirectory : string with get, set

Public Property InitialDirectory As String

Valeur de propriété

String

Répertoire initial affiché par la boîte de dialogue de fichier. La valeur par défaut est une chaîne vide ("").

Exemples

L’exemple de code suivant utilise l’implémentation OpenFileDialog de FileDialog et illustre la création, la définition des propriétés et l’affichage de la boîte de dialogue. L’exemple utilise la InitialDirectory propriété pour définir le répertoire initial lorsque la boîte de dialogue est affichée à l’utilisateur. L’exemple nécessite un formulaire avec un Button placé dessus et l’espace System.IO de noms qui lui est ajouté.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;

      openFileDialog1->InitialDirectory = "c:\\";
      openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      openFileDialog1->FilterIndex = 2;
      openFileDialog1->RestoreDirectory = true;

      if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

var fileContent = string.Empty;
var filePath = string.Empty;

using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
    openFileDialog.InitialDirectory = "c:\\";
    openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
    openFileDialog.FilterIndex = 2;
    openFileDialog.RestoreDirectory = true;

    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        //Get the path of specified file
        filePath = openFileDialog.FileName;

        //Read the contents of the file into a stream
        var fileStream = openFileDialog.OpenFile();

        using (StreamReader reader = new StreamReader(fileStream))
        {
            fileContent = reader.ReadToEnd();
        }
    }
}

MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);

Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim myStream As Stream = Nothing
    Dim openFileDialog1 As New OpenFileDialog()

    openFileDialog1.InitialDirectory = "c:\"
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    openFileDialog1.FilterIndex = 2
    openFileDialog1.RestoreDirectory = True

    If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
        Try
            myStream = openFileDialog1.OpenFile()
            If (myStream IsNot Nothing) Then
                ' Insert code to read the stream here.
            End If
        Catch Ex As Exception
            MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
        Finally
            ' Check this again, since we need to make sure we didn't throw an exception on open.
            If (myStream IsNot Nothing) Then
                myStream.Close()
            End If
        End Try
    End If
End Sub

Remarques

La InitialDirectory propriété est généralement définie à l’aide de l’une des sources suivantes :

• Chemin précédemment utilisé dans le programme, peut-être conservé à partir de la dernière opération de répertoire ou de fichier.

• Chemin d’accès lu à partir d’une source persistante, tel qu’un paramètre d’application, une Registry ressource ou une chaîne dans l’application.

• Chemins d’accès système et utilisateur Windows standard, tels que Program Files, MyDocuments, MyMusic, etc. (que vous pouvez obtenir à l’aide de la GetFolderPath méthode )

• Chemin d’accès lié à l’application actuelle, tel que son répertoire de démarrage (que vous pouvez obtenir à l’aide des propriétés de l’objet Application ).

Pour plus d’informations sur la création de chemins dynamiques, consultez la vue d’ensemble de la FileDialog classe.

Sur Windows Vista, si InitialDirectory est défini sur un nom de fichier complet au lieu d’un simple chemin d’accès au répertoire, le répertoire initial est défini par défaut sur le chemin d’accès de l’application ou sur le répertoire à partir duquel l’utilisateur a sélectionné un fichier pour la dernière fois.

Voir aussi

• RestoreDirectory
• Registry
• Application
• Environment
• Path