FileDialog.InitialDirectory Propriedade

Definição

Obtém ou define o diretório inicial apresentado pela caixa de diálogo do ficheiro.

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 Propriedade

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

Exemplos

O exemplo de código seguinte utiliza a OpenFileDialog implementação e FileDialog ilustra a criação, definição de propriedades e a apresentaçã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 ao utilizador. O exemplo requer um formulário com um colocado Button e o System.IO espaço de nomes 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

Observações

A InitialDirectory propriedade é normalmente definida usando uma das seguintes fontes:

  • Um caminho que foi anteriormente usado no programa, talvez mantido da última operação de diretório ou ficheiro.

  • Um caminho lido a partir de uma fonte persistente, como uma configuração de aplicação, um Registry ou um recurso de cadeia na aplicação.

  • Sistemas Windows padrão e caminhos de utilizador, como Program Files, MyDocuments, MyMusic, e assim por diante (que pode obter usando o método GetFolderPath)

  • Um caminho relacionado com a aplicação atual, como o seu diretório de arranque (que pode obter usando propriedades no Application objeto).

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

No Windows Vista, se InitialDirectory estiver definido para um nome de ficheiro completo em vez de apenas um caminho de diretório, o diretório inicial irá automaticamente para o caminho da aplicação ou para o diretório de onde o utilizador selecionou um ficheiro pela última vez.

Aplica-se a

Ver também