OpenFileDialog Class

OpenFileDialog Class
Definição
Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Exibe uma caixa de diálogo padrão que solicita que o usuário abra um arquivo. Essa classe não pode ser herdada.
VB
Public NotInheritable Class OpenFileDialog
Inherits FileDialog
Herança
Object
MarshalByRefObject
Component
CommonDialog
FileDialog
OpenFileDialog
Exemplos
O exemplo de código a seguir cria uma OpenFileDialog, define várias propriedades para definir o comportamento de
filtro e a caixa de diálogo de extensão do arquivo e exibe a caixa de diálogo usando o CommonDialog.ShowDialog
método. O exemplo exige um formulário com um Button colocados nele e uma referência para o System.IO namespace
adicionado a ele.
VB
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 que você verificar se existe um arquivo e abri-lo. O ShowReadOnly propriedade determina se uma
caixa de seleção somente leitura aparece na caixa de diálogo. O ReadOnlyChecked propriedade indica se a caixa de
seleção somente leitura é verificada.
A maioria da funcionalidade principal para essa classe é encontrada no FileDialog classe.
Em um sistema de operacional da direita para esquerda, a configuração do formulário que contém RightToLeft
propriedade para RightToLeft.Yes localiza a caixa de diálogo nome do arquivo, abrir, e Cancelar botões. Se a
propriedade não está definida como RightToLeft.Yes, texto em inglês é usado em vez disso.
Se você quiser dar ao usuário a capacidade de selecionar uma pasta em vez de um arquivo, use FolderBrowserDialog
em vez disso.
Construtores
OpenFileDialog() Inicializa uma instância da classe OpenFileDialog.
Propriedades
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.
(Inherited from FileDialog)
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 Vista.
CanRaiseEvents Obtém um valor que indica se o componente pode acionar
um evento.
(Inherited from Component)
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.
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.
Container Obtém o IContainer que contém o Component.
CustomPlaces Obtém a coleção de locais personalizados para esta
instância de FileDialog.
DefaultExt Obtém ou define a extensão de nome de arquivo padrão.
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).
DesignMode Obtém um valor que indica se o Component está no modo
de design no momento.
Events Obtém a lista de manipuladores de eventos que estão
anexados a este Component.
FileName Obtém ou define uma cadeia de caracteres que contém o
nome do arquivo selecionado na caixa de diálogo de
arquivo.
FileNames Obtém os nomes de arquivo de todos os arquivos
selecionados na caixa de diálogo.
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.
FilterIndex Obtém ou define o índice do filtro selecionado no
momento na caixa de diálogo do arquivo.
InitialDirectory Obtém ou define o diretório inicial exibido pela caixa de
diálogo de arquivo.
Instance Obtém o identificador de instância do Win32 para o
aplicativo.
Multiselect Obtém ou define um valor que indica se a caixa de diálogo
permite que vários arquivos sejam selecionados.
Options Obtém os valores para inicializar o FileDialog.
ReadOnlyChecked Obtém ou define um valor que indica se a caixa de seleção
somente leitura está marcada.
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.
SafeFileName Obtém o nome do arquivo e a extensão para o arquivo
selecionado na caixa de diálogo. O nome do arquivo não
inclui o caminho.
SafeFileNames Obtém uma matriz de nomes de arquivo e extensões de
todos os arquivos selecionados na caixa de diálogo. Os
nomes do arquivo não incluem o caminho.
ShowHelp Obtém ou define um valor que indica se o botão Ajuda é
exibido na caixa de diálogo de arquivo.
ShowReadOnly Obtém ou define um valor que indica se a caixa de diálogo
contém uma caixa de seleção somente leitura.
Site Obtém ou define o ISite do Component.
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.
Tag Obtém ou define um objeto que contém dados sobre o
controle.
(Inherited from CommonDialog)
Title Obtém ou define o título da caixa de diálogo do arquivo.
ValidateNames Obtém ou define um valor que indica se a caixa de diálogo
aceita somente nomes de arquivo Win32 válidos.
Métodos
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.
(Inherited from MarshalByRefObject)
Dispose() Libera todos os recursos usados pelo Component.
Dispose(Boolean) Libera os recursos não gerenciados usados pelo
Component e opcionalmente libera os recursos
gerenciados.
Equals(Object) Determina se o objeto especificado é igual ao objeto atual.
(Inherited from Object)
GetHashCode() Serve como a função de hash padrão.
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.
GetService(Type) Retorna um objeto que representa um serviço fornecido
pelo Component ou pelo seu Container.
GetType() Obtém o Type da instância atual.
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.
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.
MemberwiseClone() Cria uma cópia superficial do Object atual.
MemberwiseClone(Boolean) Cria uma cópia superficial do objeto MarshalByRefObject
atual.
OnFileOk(CancelEventArgs) Aciona o evento FileOk.
OnHelpRequest(EventArgs) Aciona o evento HelpRequest.
OpenFile() Abre o arquivo selecionado pelo usuário, com permissão
somente leitura. O arquivo é especificado pela
propriedade FileName.
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.
Reset() Redefine todas as propriedades para seus valores padrão.
RunDialog(IntPtr) Especifica uma caixa de diálogo comum.
ShowDialog() Executa uma caixa de diálogo comum com um
proprietário padrão.
ShowDialog(IWin32Window) Executa uma caixa de diálogo comum com o proprietário
especificado.
ToString() Fornece uma versão de cadeia de caracteres deste objeto.
Eventos
Disposed Ocorre quando o componente é disposto por uma chamada
para o método Dispose().
FileOk Ocorre quando o usuário clica no botão Abrir ou Salvar
na caixa de diálogo do arquivo.
HelpRequest Ocorre quando o usuário clica no botão Ajuda em uma
caixa de diálogo comum.
Aplica-se a
.NET Core
3.0 Preview 3
.NET Framework
4.8 4.7.2 4.7.1 4.7 4.6.2 4.6.1 4.6 4.5.2 4.5.1 4.5 4.0 3.5 3.0 2.0 1.1

OpenFileDialog Class

Enviado por

Dados do documento

Descrição original:

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

OpenFileDialog Class

Enviado por

Direitos autorais:

Formatos disponíveis

OpenFileDialog Class

If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then

Você também pode gostar