Compartilhar via


OpenFileDialog Classe

Definição

Representa uma caixa de diálogo comum que permite ao usuário especificar um nome de arquivo para um ou mais arquivos a abrir.

public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialog
public sealed class OpenFileDialog : Microsoft.Win32.FileDialog
type OpenFileDialog = class
    inherit FileDialog
Public NotInheritable Class OpenFileDialog
Inherits FileDialog
Herança
OpenFileDialog
Herança

Exemplos

O exemplo a seguir mostra como criar um OpenFileDialog que contém um nome de arquivo padrão e um tipo de extensão.

// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process open file dialog box results
if (result == true)
{
    // Open document
    string filename = dlg.FileName;
}
' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show open file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process open file dialog box results
If result = True Then
    ' Open document
    Dim filename As String = dlg.FileName
End If

Comentários

Você não pode declarar essa classe gerenciada em XAML.

Construtores

OpenFileDialog()

Inicializa uma nova instância da classe OpenFileDialog.

Propriedades

AddExtension

Obtém ou define um valor que indica se uma caixa de diálogo de arquivo adiciona automaticamente uma extensão a um nome de arquivo se o usuário omite uma extensão.

(Herdado de FileDialog)
AddToRecent

Obtém ou define um valor que indica se a caixa de diálogo adicionará o item que está sendo aberto ou salvo na lista de documentos recentes.

(Herdado de CommonItemDialog)
CheckFileExists

Obtém ou define um valor que indica se uma caixa de diálogo de arquivo exibe um aviso se o usuário especifica um nome de arquivo que não existe.

(Herdado de FileDialog)
CheckPathExists

Obtém ou define um valor que especifica se os avisos serão exibidos caso o usuário digite caminhos e nomes de arquivo inválidos.

(Herdado de FileDialog)
ClientGuid

Obtém ou define um GUID a ser associado ao estado persistente da caixa de diálogo.

(Herdado de CommonItemDialog)
CustomPlaces

Obtém ou define a lista de locais personalizados para caixas de diálogo de arquivo.

(Herdado de FileDialog)
DefaultDirectory

Obtém ou define o diretório exibido pela caixa de diálogo de arquivo se nenhum valor de diretório usado recentemente estiver disponível.

(Herdado de CommonItemDialog)
DefaultExt

Obtém ou define um valor que especifica a cadeia de caracteres de extensão padrão usada para filtrar a lista de arquivos exibidos.

(Herdado de FileDialog)
DereferenceLinks

Obtém ou define um valor que indica se a caixa de diálogo retorna o local do arquivo referenciado pelo atalho ou o local do arquivo de atalho (.lnk).

(Herdado de FileDialog)
FileName

Obtém ou define uma cadeia de caracteres que contém o caminho completo do arquivo selecionado em uma caixa de diálogo de arquivo.

(Herdado de FileDialog)
FileNames

Obtém uma matriz que contém um nome de arquivo para cada arquivo selecionado.

(Herdado de FileDialog)
Filter

Obtém ou define a cadeia de caracteres de filtro que determina que tipos de arquivos são exibidos no OpenFileDialog ou no SaveFileDialog.

(Herdado de FileDialog)
FilterIndex

Obtém ou define o índice do filtro selecionado no momento na caixa de diálogo do arquivo.

(Herdado de FileDialog)
ForcePreviewPane

Obtém ou define um sinalizador de opção que indica se a caixa de diálogo força o painel de visualização ativado.

InitialDirectory

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

(Herdado de FileDialog)
Multiselect

Obtém ou define uma opção que indica se OpenFileDialog permite aos usuários selecionar vários arquivos.

Options

Obtém os sinalizadores de diálogo de arquivo comuns do Win32 que são usados por caixas de diálogo de arquivo para inicialização.

(Herdado de FileDialog)
ReadOnlyChecked

Obtém ou define um valor que indica se a caixa de seleção somente leitura exibida por OpenFileDialog está marcada.

RestoreDirectory

Esta propriedade não é implementada.

(Herdado de FileDialog)
RootDirectory

Obtém ou define o diretório exibido como a raiz de navegação da caixa de diálogo.

(Herdado de CommonItemDialog)
SafeFileName

Obtém uma cadeia de caracteres que contém apenas o nome do arquivo para o arquivo selecionado.

(Herdado de FileDialog)
SafeFileNames

Obtém uma matriz que contém um nome de arquivo seguro para cada arquivo selecionado.

(Herdado de FileDialog)
ShowHiddenItems

Obtém ou define um valor que indica se a caixa de diálogo mostrará itens ocultos e do sistema, independentemente das preferências do usuário.

(Herdado de CommonItemDialog)
ShowReadOnly

Obtém ou define um valor que indica se OpenFileDialog contém uma caixa de seleção somente leitura.

Tag

Obtém ou define um objeto associado a essa caixa de diálogo. Isso fornece a capacidade de anexar um objeto arbitrário à caixa de diálogo.

(Herdado de CommonDialog)
Title

Obtém ou define o texto que aparece na barra de título de uma caixa de diálogo de arquivo.

(Herdado de FileDialog)
ValidateNames

Obtém ou define um valor que indica se a caixa de diálogo aceita apenas nomes de arquivo Win32 válidos.

(Herdado de FileDialog)

Métodos

CheckPermissionsToShowDialog()

Determina se existem permissões suficientes para exibir uma caixa de diálogo.

(Herdado de CommonDialog)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Define o procedimento de gancho de caixa de diálogo de arquivo comum que é substituído para adicionar uma funcionalidade comum à caixa de diálogo comum.

(Herdado de FileDialog)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnFileOk(CancelEventArgs)

Aciona o evento FileOk.

(Herdado de FileDialog)
OnItemOk(CancelEventArgs)

Aciona o evento FileOk.

(Herdado de FileDialog)
OpenFile()

Abre um fluxo somente leitura para o arquivo selecionado pelo usuário usando OpenFileDialog.

OpenFiles()

Cria uma matriz que contém um fluxo somente leitura para cada arquivo selecionado pelo usuário usando OpenFileDialog.

Reset()

Redefine todas as propriedades OpenFileDialog para seus valores padrão.

RunDialog(IntPtr)

RunDialog(IntPtr) é chamado para exibir uma caixa de diálogo de arquivo em uma classe derivada, tal como OpenFileDialog e SaveFileDialog.

(Herdado de FileDialog)
ShowDialog()

Exibe uma caixa de diálogo comum.

(Herdado de CommonDialog)
ShowDialog(Window)

Exibe uma caixa de diálogo comum.

(Herdado de CommonDialog)
ToString()

Retorna uma cadeia de caracteres que representa uma caixa de diálogo do arquivo.

(Herdado de FileDialog)

Eventos

FileOk

Ocorre quando o usuário seleciona um nome de arquivo clicando no botão Abrir do OpenFileDialog ou o botão Salvar botão do SaveFileDialog.

(Herdado de FileDialog)

Aplica-se a

Confira também