OpenFileDialog OpenFileDialog OpenFileDialog OpenFileDialog Class

Definição

Exibe uma caixa de diálogo padrão que solicita que o usuário abra um arquivo.Displays a standard dialog box that prompts the user to open a file. Essa classe não pode ser herdada.This class cannot be inherited.

public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialog
public sealed class OpenFileDialog : System.Windows.Forms.FileDialog
type OpenFileDialog = class
    inherit FileDialog
Public NotInheritable Class OpenFileDialog
Inherits FileDialog
Herança

Exemplos

O exemplo de código a seguir OpenFileDialogcria um, define várias propriedades para definir o comportamento de caixa de diálogo e filtro de extensão de arquivo e CommonDialog.ShowDialog exibe a caixa de diálogo usando o método.The following code example creates an OpenFileDialog, sets several properties to define the file extension filter and dialog behavior, and displays the dialog box using the CommonDialog.ShowDialog method. O exemplo requer um formulário com um Button colocado nele e uma referência System.IO ao namespace adicionado a ele.The example requires a form with a Button placed on it and a reference to the System.IO namespace added to it.

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

Essa classe permite verificar se um arquivo existe e abri-lo.This class allows you to check whether a file exists and to open it. A ShowReadOnly propriedade determina se uma caixa de seleção somente leitura aparece na caixa de diálogo.The ShowReadOnly property determines whether a read-only check box appears in the dialog box. A ReadOnlyChecked propriedade indica se a caixa de seleção somente leitura está marcada.The ReadOnlyChecked property indicates whether the read-only check box is checked.

A maior parte da funcionalidade principal para essa classe é encontrada na FileDialog classe.Most of the core functionality for this class is found in the FileDialog class.

Em um sistema operacional da direita para a esquerda, definir a propriedade do RightToLeft formulário recipiente para RightToLeft.Yes localizar os botões nome do arquivo, abrire Cancelar da caixa de diálogo.On a right-to-left operating system, setting the containing form's RightToLeft property to RightToLeft.Yes localizes the dialog's File Name, Open, and Cancel buttons. Se a propriedade não estiver definida como RightToLeft.Yes, o texto em inglês será usado.If the property is not set to RightToLeft.Yes, English text is used instead.

Se você quiser conceder ao usuário a capacidade de selecionar uma pasta em vez de um arquivo, use FolderBrowserDialog em vez disso.If you want to give the user the ability to select a folder instead of a file, use FolderBrowserDialog instead.

Construtores

OpenFileDialog() OpenFileDialog() OpenFileDialog() OpenFileDialog()

Inicializa uma instância da classe OpenFileDialog.Initializes an instance of the OpenFileDialog class.

Propriedades

AddExtension AddExtension AddExtension AddExtension

Obtém ou define um valor que indica se a caixa de diálogo adiciona automaticamente uma extensão a um nome de arquivo se o usuário omite a extensão.Gets or sets a value indicating whether the dialog box automatically adds an extension to a file name if the user omits the extension.

(Inherited from FileDialog)
AutoUpgradeEnabled AutoUpgradeEnabled AutoUpgradeEnabled AutoUpgradeEnabled

Obtém ou define um valor que indica se esta instância de FileDialog deve atualizar automaticamente a aparência e o comportamento durante a execução em Windows VistaWindows Vista.Gets or sets a value indicating whether this FileDialog instance should automatically upgrade appearance and behavior when running on Windows VistaWindows Vista.

(Inherited from FileDialog)
CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CheckFileExists CheckFileExists CheckFileExists CheckFileExists

Obtém ou define um valor que indica se a caixa de diálogo exibirá um aviso se o usuário especificar um nome de arquivo que não existe.Gets or sets a value indicating whether the dialog box displays a warning if the user specifies a file name that does not exist.

CheckPathExists CheckPathExists CheckPathExists CheckPathExists

Obtém ou define um valor que indica se a caixa de diálogo exibe um aviso se o usuário especificar um caminho que não existe.Gets or sets a value indicating whether the dialog box displays a warning if the user specifies a path that does not exist.

(Inherited from FileDialog)
Container Container Container Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
CustomPlaces CustomPlaces CustomPlaces CustomPlaces

Obtém a coleção de locais personalizados para esta instância de FileDialog.Gets the custom places collection for this FileDialog instance.

(Inherited from FileDialog)
DefaultExt DefaultExt DefaultExt DefaultExt

Obtém ou define a extensão de nome de arquivo padrão.Gets or sets the default file name extension.

(Inherited from FileDialog)
DereferenceLinks DereferenceLinks DereferenceLinks DereferenceLinks

Obtém ou define um valor que indica se a caixa de diálogo retorna o local do arquivo referenciado pelo atalho ou se ele retorna o local do atalho (.lnk).Gets or sets a value indicating whether the dialog box returns the location of the file referenced by the shortcut or whether it returns the location of the shortcut (.lnk).

(Inherited from FileDialog)
DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
FileName FileName FileName FileName

Obtém ou define uma cadeia de caracteres que contém o nome do arquivo selecionado na caixa de diálogo de arquivo.Gets or sets a string containing the file name selected in the file dialog box.

(Inherited from FileDialog)
FileNames FileNames FileNames FileNames

Obtém os nomes de arquivo de todos os arquivos selecionados na caixa de diálogo.Gets the file names of all selected files in the dialog box.

(Inherited from FileDialog)
Filter Filter Filter Filter

Obtém ou define a cadeia de caracteres do filtro de nome de arquivo atual, que determina as opções que aparecem na caixa “Salvar como tipo de arquivo” ou “Arquivos do tipo” caixa na caixa de diálogo.Gets or sets the current file name filter string, which determines the choices that appear in the "Save as file type" or "Files of type" box in the dialog box.

(Inherited from FileDialog)
FilterIndex FilterIndex FilterIndex FilterIndex

Obtém ou define o índice do filtro selecionado no momento na caixa de diálogo do arquivo.Gets or sets the index of the filter currently selected in the file dialog box.

(Inherited from FileDialog)
InitialDirectory InitialDirectory InitialDirectory InitialDirectory

Obtém ou define o diretório inicial exibido pela caixa de diálogo de arquivo.Gets or sets the initial directory displayed by the file dialog box.

(Inherited from FileDialog)
Instance Instance Instance Instance

Obtém o identificador de instância do Win32 para o aplicativo.Gets the Win32 instance handle for the application.

(Inherited from FileDialog)
Multiselect Multiselect Multiselect Multiselect

Obtém ou define um valor que indica se a caixa de diálogo permite que vários arquivos sejam selecionados.Gets or sets a value indicating whether the dialog box allows multiple files to be selected.

Options Options Options Options

Obtém os valores para inicializar o FileDialog.Gets values to initialize the FileDialog.

(Inherited from FileDialog)
ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked ReadOnlyChecked

Obtém ou define um valor que indica se a caixa de seleção somente leitura está marcada.Gets or sets a value indicating whether the read-only check box is selected.

RestoreDirectory RestoreDirectory RestoreDirectory RestoreDirectory

Obtém ou define um valor que indica se a caixa de diálogo restaura o diretório para o diretório selecionado anteriormente antes de fechar.Gets or sets a value indicating whether the dialog box restores the directory to the previously selected directory before closing.

(Inherited from FileDialog)
SafeFileName SafeFileName SafeFileName SafeFileName

Obtém o nome do arquivo e a extensão para o arquivo selecionado na caixa de diálogo.Gets the file name and extension for the file selected in the dialog box. O nome do arquivo não inclui o caminho.The file name does not include the path.

SafeFileNames SafeFileNames SafeFileNames SafeFileNames

Obtém uma matriz de nomes de arquivo e extensões de todos os arquivos selecionados na caixa de diálogo.Gets an array of file names and extensions for all the selected files in the dialog box. Os nomes do arquivo não incluem o caminho.The file names do not include the path.

ShowHelp ShowHelp ShowHelp ShowHelp

Obtém ou define um valor que indica se o botão Ajuda é exibido na caixa de diálogo de arquivo.Gets or sets a value indicating whether the Help button is displayed in the file dialog box.

(Inherited from FileDialog)
ShowReadOnly ShowReadOnly ShowReadOnly ShowReadOnly

Obtém ou define um valor que indica se a caixa de diálogo contém uma caixa de seleção somente leitura.Gets or sets a value indicating whether the dialog box contains a read-only check box.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
SupportMultiDottedExtensions SupportMultiDottedExtensions SupportMultiDottedExtensions SupportMultiDottedExtensions

Obtém ou define se a caixa de diálogo dá suporte a exibir e salvar arquivos que têm várias extensões de nome de arquivo.Gets or sets whether the dialog box supports displaying and saving files that have multiple file name extensions.

(Inherited from FileDialog)
Tag Tag Tag Tag

Obtém ou define um objeto que contém dados sobre o controle.Gets or sets an object that contains data about the control.

(Inherited from CommonDialog)
Title Title Title Title

Obtém ou define o título da caixa de diálogo do arquivo.Gets or sets the file dialog box title.

(Inherited from FileDialog)
ValidateNames ValidateNames ValidateNames ValidateNames

Obtém ou define um valor que indica se a caixa de diálogo aceita somente nomes de arquivo Win32 válidos.Gets or sets a value indicating whether the dialog box accepts only valid Win32 file names.

(Inherited from FileDialog)

Métodos

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr)

Define o procedimento de gancho de caixa de diálogo comum que é substituído para adicionar uma funcionalidade específica à caixa de diálogo do arquivo.Defines the common dialog box hook procedure that is overridden to add specific functionality to the file dialog box.

(Inherited from FileDialog)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs)

Aciona o evento FileOk.Raises the FileOk event.

(Inherited from FileDialog)
OnHelpRequest(EventArgs) OnHelpRequest(EventArgs) OnHelpRequest(EventArgs) OnHelpRequest(EventArgs)

Aciona o evento HelpRequest.Raises the HelpRequest event.

(Inherited from CommonDialog)
OpenFile() OpenFile() OpenFile() OpenFile()

Abre o arquivo selecionado pelo usuário, com permissão somente leitura.Opens the file selected by the user, with read-only permission. O arquivo é especificado pela propriedade FileName.The file is specified by the FileName property.

OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

Define o procedimento da janela de proprietário que é substituído para adicionar a funcionalidade específica a uma caixa de diálogo comum.Defines the owner window procedure that is overridden to add specific functionality to a common dialog box.

(Inherited from CommonDialog)
Reset() Reset() Reset() Reset()

Redefine todas as propriedades para seus valores padrão.Resets all properties to their default values.

RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr)

Especifica uma caixa de diálogo comum.Specifies a common dialog box.

(Inherited from FileDialog)
ShowDialog() ShowDialog() ShowDialog() ShowDialog()

Executa uma caixa de diálogo comum com um proprietário padrão.Runs a common dialog box with a default owner.

(Inherited from CommonDialog)
ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window)

Executa uma caixa de diálogo comum com o proprietário especificado.Runs a common dialog box with the specified owner.

(Inherited from CommonDialog)
ToString() ToString() ToString() ToString()

Fornece uma versão de cadeia de caracteres deste objeto.Provides a string version of this object.

(Inherited from FileDialog)

Eventos

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
FileOk FileOk FileOk FileOk

Ocorre quando o usuário clica no botão Abrir ou Salvar na caixa de diálogo do arquivo.Occurs when the user clicks on the Open or Save button on a file dialog box.

(Inherited from FileDialog)
HelpRequest HelpRequest HelpRequest HelpRequest

Ocorre quando o usuário clica no botão Ajuda em uma caixa de diálogo comum.Occurs when the user clicks the Help button on a common dialog box.

(Inherited from CommonDialog)

Aplica-se a

Veja também