FileDialog.InitialDirectory-Eigenschaft

Artikel
08/20/2007

Ruft das Ausgangsverzeichnis ab, das im Dateidialogfeld angezeigt wird, oder legt dieses fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property InitialDirectory As String
'Usage
Dim instance As FileDialog
Dim value As String

value = instance.InitialDirectory

instance.InitialDirectory = value

public string InitialDirectory { get; set; }

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

/** @property */
public String get_InitialDirectory ()

/** @property */
public void set_InitialDirectory (String value)

public function get InitialDirectory () : String

public function set InitialDirectory (value : String)

Eigenschaftenwert

Das Ausgangsverzeichnis, das im Dateidialogfeld angezeigt wird. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Die InitialDirectory-Eigenschaft wird i. d. R. mit einer der folgenden Quellen festgelegt:

Ein zuvor im Programm verwendeter Pfad, möglicherweise aus dem letzten Verzeichnis oder der letzten Dateioperation beibehalten.
Ein aus einer beständigen Quelle gelesener Pfad, z. B. eine Anwendungseinstellung, eine Registry oder eine Zeichenfolgenressource in der Anwendung.
Windows-Standardsystempfade und -Benutzerpfade, z. B. Programme, MyDocuments, MyMusic, usw.
Ein auf die aktuelle Anwendung bezogener Pfad, z. B. das Startverzeichnis.

Weitere Informationen zum Erstellen von dynamischen Pfaden finden Sie in der Übersicht über die FileDialog-Klasse.

Beispiel

Im folgenden Codebeispiel wird die OpenFileDialog-Implementierung von FileDialog verwendet und veranschaulicht, wie ein Dialogfeld erstellt und nach Festlegen der Eigenschaften angezeigt wird. Im Beispiel wird das Ausgangsverzeichnis anhand der InitialDirectory-Eigenschaft festgelegt, wenn das Dialogfeld dem Benutzer angezeigt wird. Voraussetzung für dieses Beispiel ist ein Formular, auf dem Button platziert und dem der System.IO-Namespace hinzugefügt wurde.

Private Sub button1_Click(sender As Object, e As System.EventArgs)
    Dim myStream As Stream
    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() = DialogResult.OK Then
        myStream = openFileDialog1.OpenFile()
        If Not (myStream Is Nothing) Then
            ' Insert code to read the stream here.
            myStream.Close()
        End If
    End If
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Stream myStream;
    OpenFileDialog openFileDialog1 = new OpenFileDialog();

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

    if(openFileDialog1.ShowDialog() == DialogResult.OK)
    {
        if((myStream = openFileDialog1.OpenFile())!= null)
        {
            // Insert code to read the stream here.
            myStream.Close();
        }
    }
}

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() == ::DialogResult::OK )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

protected void button1_Click(Object sender, System.EventArgs e)
{
    Stream myStream;
    OpenFileDialog openFileDialog1 = new OpenFileDialog();
    openFileDialog1.set_InitialDirectory("c:\\");
    openFileDialog1.set_Filter(
        "txt files (*.txt)|*.txt|All files (*.*)|*.*");
    openFileDialog1.set_FilterIndex(2);
    openFileDialog1.set_RestoreDirectory(true);
    if (openFileDialog1.ShowDialog().Equals(get_DialogResult().OK)) {
        if ((myStream = openFileDialog1.OpenFile()) != null) {
            // Insert code to read the stream here.
            myStream.Close();
        }
    }
} //button1_Click

.NET Framework-Sicherheit

FileIOPermission Erforderlich zum Festlegen des anfänglichen Verzeichnisses. Zugeordnete Enumeration: PermissionState.Unrestricted.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

FileDialog-Klasse
FileDialog-Member
System.Windows.Forms-Namespace
RestoreDirectory
Registry
Application-Klasse
System.Environment
System.IO.Path

Freigeben über