FileDialog.InitialDirectory Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el directorio inicial que muestra el cuadro de diálogo de archivo.

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

Valor de propiedad

String

Directorio inicial que muestra el cuadro de diálogo de archivo. El valor predeterminado es una cadena vacía ("").

Ejemplos

En el ejemplo de código siguiente se usa la implementación de FileDialog y se muestra cómo OpenFileDialog crear, establecer propiedades y mostrar el cuadro de diálogo. En el ejemplo se usa la InitialDirectory propiedad para establecer lo que es el directorio inicial cuando se muestra el cuadro de diálogo al usuario. El ejemplo requiere un formulario con un Button colocado en él y el System.IO espacio de nombres agregado a él.

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

Comentarios

Normalmente, la InitialDirectory propiedad se establece mediante uno de los orígenes siguientes:

• Ruta de acceso que se usó anteriormente en el programa, quizás conservada del último directorio o operación de archivo.

• Una ruta de acceso leída desde un origen persistente, como una configuración de aplicación, un Registry recurso de cadena o en la aplicación.

• Rutas de acceso estándar del sistema y del usuario de Windows, como Archivos de programa, MyDocuments, MyMusic, etc. (que puede obtener mediante el GetFolderPath método )

• Ruta de acceso relacionada con la aplicación actual, como su directorio de inicio (que puede obtener mediante propiedades en el Application objeto ).

Para obtener más información sobre cómo crear rutas de acceso dinámicas, consulte la información general de la FileDialog clase.

En Windows Vista, si InitialDirectory se establece en un nombre de archivo completo en lugar de solo una ruta de acceso de directorio, el directorio inicial se establecerá de forma predeterminada en la ruta de acceso de la aplicación o en el directorio desde el que el usuario seleccionó por última vez un archivo.

Consulte también

• RestoreDirectory
• Registry
• Application
• Environment
• Path