OpenFileDialog Classe

Referência

Definição

Namespace:: Microsoft.Win32

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object

CommonDialog

FileDialog
OpenFileDialog

Herança: Object

CommonDialog

CommonItemDialog

FileDialog
OpenFileDialog

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

SaveFileDialog

Compartilhar via