FileDialog.InitialDirectory Propriedade

Definição

Obtém ou define o diretório inicial exibido pela caixa de diálogo de arquivo.

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 da propriedade

O diretório inicial exibido pela caixa de diálogo do arquivo. O padrão é uma cadeia de caracteres vazia ("").

Exemplos

O exemplo de código a seguir usa a OpenFileDialog implementação de FileDialog e ilustra a criação, a configuração de propriedades e a exibição da caixa de diálogo. O exemplo usa a InitialDirectory propriedade para definir qual é o diretório inicial quando a caixa de diálogo é exibida para o usuário. O exemplo requer um formulário com um Button colocado nele e o System.IO namespace adicionado a ele.

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

Comentários

Normalmente InitialDirectory , a propriedade é definida usando uma das seguintes fontes:

  • Um caminho que foi usado anteriormente no programa, talvez retido do último diretório ou operação de arquivo.

  • Um caminho lido de uma fonte persistente, como uma configuração de aplicativo, um Registry ou um recurso de cadeia de caracteres no aplicativo.

  • Caminhos de usuário e sistema Padrão do Windows, como Arquivos de Programas, MyDocuments, MyMusic e assim por diante (que você pode obter usando o GetFolderPath método)

  • Um caminho relacionado ao aplicativo atual, como seu diretório de inicialização (que você pode obter usando propriedades no Application objeto).

Para obter mais informações sobre como criar caminhos dinâmicos, consulte a visão geral da FileDialog classe.

No Windows Vista, se InitialDirectory estiver definido como um nome de arquivo completo em vez de apenas um caminho de diretório, o diretório inicial usará como padrão o caminho do aplicativo ou o diretório do qual o usuário selecionou um arquivo pela última vez.

Aplica-se a

Confira também