OpenFileDialog Classe

Definição

Espaço de Nomes:
Microsoft.Win32
Assemblagem:
PresentationFramework.dll

Representa uma caixa de diálogo comum que permite ao utilizador especificar um nome de ficheiro para um ou mais ficheiros 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 seguinte mostra como criar um OpenFileDialog que contenha um nome de ficheiro predefinido 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.Value)
{
    // 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

Observações

Não podes declarar esta classe gerida em XAML.

Construtores

Name Description
OpenFileDialog()

Inicializa uma nova instância da OpenFileDialog classe.

Propriedades

Name Description
AddExtension

Recebe ou define um valor que indica se um diálogo de ficheiro adiciona automaticamente uma extensão a um nome de ficheiro se o utilizador omitir uma extensão.

(Herdado de FileDialog)
AddToRecent

Recebe ou define um valor que indica se a caixa de diálogo irá adicionar o item que está a ser aberto ou guardado à lista de documentos recentes.

(Herdado de CommonItemDialog)
CheckFileExists

Recebe ou define um valor que indica se um diálogo de ficheiro apresenta um aviso se o utilizador especificar um nome de ficheiro que não existe.

(Herdado de FileDialog)
CheckPathExists

Recebe ou define um valor que especifica se os avisos são exibidos se o utilizador escrever caminhos e nomes de ficheiros inválidos.

(Herdado de FileDialog)
ClientGuid

Obtém ou define um GUID para associar ao estado persistente do diálogo.

(Herdado de CommonItemDialog)
CustomPlaces

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

(Herdado de FileDialog)
DefaultDirectory

Obtém ou define o diretório apresentado pela caixa de diálogo do ficheiro se não houver valor de diretório usado recentemente.

(Herdado de CommonItemDialog)
DefaultExt

Recebe ou define um valor que especifica a cadeia de extensão padrão a usar para filtrar a lista de ficheiros que são exibidos.

(Herdado de FileDialog)
DereferenceLinks

Recebe ou define um valor que indica se um diálogo de ficheiro devolve a localização do ficheiro referenciado por um atalho ou a localização do ficheiro de atalho (.lnk).

(Herdado de FileDialog)
FileName

Obtém ou define uma cadeia contendo o caminho completo do ficheiro selecionado num diálogo de ficheiro.

(Herdado de FileDialog)
FileNames

Recebe um array que contém um nome de ficheiro para cada ficheiro selecionado.

(Herdado de FileDialog)
Filter

Obtém ou define a cadeia de filtro que determina que tipos de ficheiros são exibidos a partir do OpenFileDialog ou SaveFileDialog.

(Herdado de FileDialog)
FilterIndex

Obtém ou define o índice do filtro atualmente selecionado numa caixa de diálogo de ficheiros.

(Herdado de FileDialog)
ForcePreviewPane

Recebe ou define uma opção que indica se a caixa de diálogo força o painel de pré-visualização ativado.
InitialDirectory

Obtém ou define o diretório inicial que é mostrado por um diálogo de ficheiros.

(Herdado de FileDialog)
Multiselect

Recebe ou define uma opção que indica se OpenFileDialog permite aos utilizadores selecionar vários ficheiros.
Options

Obtém os flags de diálogo de ficheiros comuns do Win32 que são usados pelos diálogos de ficheiros para inicialização.

(Herdado de FileDialog)
ReadOnlyChecked

Recebe ou define um valor que indica se a caixa de verificação só de leitura exibida por OpenFileDialog está selecionada.
RestoreDirectory

Esta propriedade não está implementada.

(Herdado de FileDialog)
RootDirectory

Recebe ou define o diretório exibido como raiz de navegação para o diálogo.

(Herdado de CommonItemDialog)
SafeFileName

Recebe uma cadeia que contém apenas o nome do ficheiro selecionado.

(Herdado de FileDialog)
SafeFileNames

Recebe um array que contém um nome de ficheiro seguro para cada ficheiro selecionado.

(Herdado de FileDialog)
ShowHiddenItems

Recebe ou define um valor que indica se a caixa de diálogo mostrará itens ocultos e do sistema, independentemente das preferências do utilizador.

(Herdado de CommonItemDialog)
ShowReadOnly

Recebe ou define um valor que indica se OpenFileDialog contém uma caixa de verificação só de leitura.
Tag

Recebe ou define um objeto associado ao diálogo. Isto permite anexar um objeto arbitrário ao diálogo.

(Herdado de CommonDialog)
Title

Recebe ou define o texto que aparece na barra de título de um diálogo de ficheiros.

(Herdado de FileDialog)
ValidateNames

Recebe ou define um valor que indica se o diálogo aceita apenas nomes válidos de ficheiros Win32.

(Herdado de FileDialog)

Métodos

Name Description
CheckPermissionsToShowDialog()

Determina se existem permissões suficientes para exibir um diálogo.

(Herdado de CommonDialog)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

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

Define o procedimento comum de hook de diálogo de ficheiros que é sobreposto para adicionar funcionalidade comum a um diálogo de ficheiros.

(Herdado de FileDialog)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnFileOk(CancelEventArgs)

Eleva o FileOk evento.

(Herdado de FileDialog)
OnItemOk(CancelEventArgs)

Eleva o FileOk evento.

(Herdado de FileDialog)
OpenFile()

Abre um fluxo de só leitura para o ficheiro selecionado pelo utilizador usando OpenFileDialog.
OpenFiles()

Cria um array que contém um fluxo de apenas leitura para cada ficheiro selecionado pelo utilizador usando OpenFileDialog.
Reset()

Reinicia todas OpenFileDialog as propriedades para os seus valores padrão.
RunDialog(IntPtr)

RunDialog(IntPtr) é chamado para mostrar um diálogo de ficheiro numa classe derivada, como OpenFileDialog e SaveFileDialog.

(Herdado de FileDialog)
ShowDialog()

Apresenta um diálogo comum.

(Herdado de CommonDialog)
ShowDialog(Window)

Apresenta um diálogo comum.

(Herdado de CommonDialog)
ToString()

Devolve uma string que representa um diálogo de ficheiro.

(Herdado de FileDialog)

evento

Name Description
FileOk

Ocorre quando o utilizador seleciona um nome de ficheiro clicando no botão Abrir ou OpenFileDialog no botão Guardar do SaveFileDialogarquivo .

(Herdado de FileDialog)

Aplica-se a

Ver também