FileDialog Classe

Definição

public ref class FileDialog abstract : System::Windows::Forms::CommonDialog

public abstract class FileDialog : System.Windows.Forms.CommonDialog

type FileDialog = class
    inherit CommonDialog

Public MustInherit Class FileDialog
Inherits CommonDialog

Herança

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

Derivado

System.Windows.Forms.OpenFileDialog

System.Windows.Forms.SaveFileDialog

Exemplos

O exemplo de código a seguir usa a OpenFileDialog implementação e FileDialog ilustra a criação, a configuração das propriedades e a exibição da caixa de diálogo. O exemplo usa o ShowDialog método para exibir a caixa de diálogo e retornar o DialogResult. 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

FileDialogé uma classe abstrata que contém um comportamento comum para as classes e SaveFileDialog as OpenFileDialog classes. Ele não se destina a ser usado diretamente, mas contém um comportamento comum para essas duas classes. Você não pode criar uma instância de FileDialog. Embora a classe seja declarada pública, você não pode herdar dela, pois ela contém métodos abstratos internos. Para criar uma caixa de diálogo para selecionar ou salvar um arquivo, use OpenFileDialog ou SaveFileDialog.

FileDialog é uma caixa de diálogo modal; portanto, quando mostrado, ele bloqueia o restante do aplicativo até que o usuário tenha escolhido um arquivo. Quando uma caixa de diálogo é exibida modally, nenhuma entrada (teclado ou clique no mouse) pode ocorrer, exceto para objetos na caixa de diálogo. O programa deve ocultar ou fechar a caixa de diálogo (geralmente em resposta a alguma ação do usuário) antes que a entrada no programa de chamada possa ocorrer.

Se você quiser permitir que os usuários selecionem uma pasta em vez de um arquivo, use o FolderBrowserDialog.

Dependendo do tipo de aplicativo, de como os dados associados ao aplicativo são armazenados e do motivo para acessar o sistema de arquivos, há muitas maneiras possíveis de criar um caminho de diretório. A tabela a seguir mostra as técnicas para criar caminhos dinamicamente.

Observe que um caminho completo pode ser criado usando uma ou mais das técnicas descritas. Por exemplo, o GetFolderPath método pode ser usado para obter o caminho para a pasta MyDocuments e, em seguida, uma configuração de aplicativo pode ser usada para adicionar uma parte relativa do subdiretório.

A System.IO.Path classe contém membros estáticos para ajudar na manipulação de cadeias de caracteres de caminho absolutas e relativas, enquanto as classes e os System.IO.File membros System.IO.Directory estáticos que realmente manipulam arquivos e diretórios, respectivamente.

Confira também

• CommonDialog
• OpenFileDialog
• SaveFileDialog
• FolderBrowserDialog
• Path
• File
• Directory
• Environment
• Application
• Registry
• ResourceReader