OpenFileDialog Classe

Definição

Espaço de Nomes:: System.Windows.Forms

Assemblagem:: System.Windows.Forms.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Mostra uma caixa de diálogo padrão que pede ao utilizador para abrir um ficheiro. Esta classe não pode ser herdada.

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

MarshalByRefObject

Component

CommonDialog

FileDialog
OpenFileDialog

Exemplos

O exemplo de código seguinte cria um OpenFileDialog, define várias propriedades para definir o filtro de extensão de ficheiro e o comportamento de diálogo, e apresenta a caixa de diálogo usando o CommonDialog.ShowDialog método. O exemplo requer um formulário com um Button colocado e uma referência ao System.IO namespace adicionada a ele.

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

Observações

Esta classe permite-lhe verificar se um ficheiro existe e abri-lo. A ShowReadOnly propriedade determina se aparece uma caixa de seleção de apenas leitura na caixa de diálogo. A ReadOnlyChecked propriedade indica se a caixa de seleção de apenas leitura está assinalada.

A maior parte da funcionalidade central desta classe encontra-se nela FileDialog .

Num sistema operativo da direita para a esquerda, definir a propriedade do RightToLeft formulário que contém localiza RightToLeft.Yes os botões Nome do Ficheiro, Abrir e Cancelar do diálogo. Se a propriedade não estiver definida para RightToLeft.Yes, é usado texto em inglês.

Se quiser dar ao utilizador a possibilidade de selecionar uma pasta em vez de um ficheiro, use FolderBrowserDialog em vez disso.

Construtores

Name	Description
OpenFileDialog()	Inicializa uma instância da OpenFileDialog classe.

Propriedades

Name	Description
AddExtension	Recebe ou define um valor que indica se a caixa de diálogo adiciona automaticamente uma extensão a um nome de ficheiro caso o utilizador omita essa extensão. (Herdado de FileDialog)
AutoUpgradeEnabled	Recebe ou define um valor que indica se esta instância FileDialog deve atualizar automaticamente a aparência e o comportamento ao correr em Windows Vista. (Herdado de FileDialog)
CanRaiseEvents	Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component)
CheckFileExists	Recebe ou define um valor que indica se a caixa de diálogo apresenta um aviso se o utilizador especificar um nome de ficheiro que não existe.
CheckPathExists	Recebe ou define um valor que indica se a caixa de diálogo apresenta um aviso se o utilizador especificar um caminho que não existe. (Herdado de FileDialog)
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
CustomPlaces	Recebe a coleção de lugares personalizados neste FileDialog caso. (Herdado de FileDialog)
DefaultExt	Obtém ou define a extensão padrão do nome do ficheiro. (Herdado de FileDialog)
DereferenceLinks	Recebe ou define um valor que indica se a caixa de diálogo devolve a localização do ficheiro referenciado pelo atalho ou se devolve a localização do atalho (.lnk). (Herdado de FileDialog)
DesignMode	Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component)
Events	Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component)
FileName	Obtém ou define uma string contendo o nome do ficheiro selecionado na caixa de diálogo do ficheiro. (Herdado de FileDialog)
FileNames	Obtém os nomes dos ficheiros de todos os ficheiros selecionados na caixa de diálogo. (Herdado de FileDialog)
Filter	Recebe ou define a cadeia de filtro do nome de ficheiro atual, que determina as opções que aparecem na caixa "Guardar como tipo de ficheiro" ou "Ficheiros do tipo" na caixa de diálogo. (Herdado de FileDialog)
FilterIndex	Obtém ou define o índice do filtro atualmente selecionado na caixa de diálogo do ficheiro. (Herdado de FileDialog)
InitialDirectory	Obtém ou define o diretório inicial apresentado pela caixa de diálogo do ficheiro. (Herdado de FileDialog)
Instance	Obtém o controlo da instância Win32 para a aplicação. (Herdado de FileDialog)
Multiselect	Recebe ou define um valor que indica se a caixa de diálogo permite selecionar vários ficheiros.
Options	Obtém valores para inicializar o FileDialog. (Herdado de FileDialog)
ReadOnlyChecked	Recebe ou define um valor que indica se a caixa de verificação só de leitura está selecionada.
RestoreDirectory	Recebe ou define um valor que indica se a caixa de diálogo restaura o diretório para o diretório previamente selecionado antes de fechar. (Herdado de FileDialog)
SafeFileName	Obtém o nome do ficheiro e a extensão do ficheiro selecionados na caixa de diálogo. O nome do ficheiro não inclui o caminho.
SafeFileNames	Obtém um array de nomes de ficheiros e extensões para todos os ficheiros selecionados na caixa de diálogo. Os nomes dos ficheiros não incluem o caminho.
ShowHelp	Recebe ou define um valor que indica se o botão Ajuda é exibido na caixa de diálogo do ficheiro. (Herdado de FileDialog)
ShowReadOnly	Recebe ou define um valor que indica se a caixa de diálogo contém uma caixa de seleção de apenas leitura.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
SupportMultiDottedExtensions	Obtém ou define se a caixa de diálogo suporta mostrar e guardar ficheiros com múltiplas extensões de nomes de ficheiro. (Herdado de FileDialog)
Tag	Obtém ou define um objeto que contém dados sobre o controlo. (Herdado de CommonDialog)
Title	Recebe ou define o título da caixa de diálogo do ficheiro. (Herdado de FileDialog)
ValidateNames	Recebe ou define um valor que indica se a caixa de diálogo aceita apenas nomes válidos de ficheiros Win32. (Herdado de FileDialog)

Métodos

Name	Description
CreateObjRef(Type)	Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Liberta todos os recursos utilizados pelo Component. (Herdado de Component)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos. (Herdado de Component)
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)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject)
GetService(Type)	Devolve um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Define o procedimento comum de gancho da caixa de diálogo que é sobreposto para adicionar funcionalidades específicas à caixa de diálogo do ficheiro. (Herdado de FileDialog)
InitializeLifetimeService()	Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
OnFileOk(CancelEventArgs)	Eleva o FileOk evento. (Herdado de FileDialog)
OnHelpRequest(EventArgs)	Eleva o HelpRequest evento. (Herdado de CommonDialog)
OpenFile()	Abre o ficheiro selecionado pelo utilizador, com permissão de apenas leitura. O ficheiro é especificado pela FileName propriedade.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Define o procedimento da janela proprietária que é sobreposto para adicionar funcionalidades específicas a uma caixa de diálogo comum. (Herdado de CommonDialog)
Reset()	Reinicia todas as propriedades para os seus valores padrão.
RunDialog(IntPtr)	Especifica uma caixa de diálogo comum. (Herdado de FileDialog)
ShowDialog()	Executa uma caixa de diálogo comum com um proprietário padrão. (Herdado de CommonDialog)
ShowDialog(IWin32Window)	Executa uma caixa de diálogo comum com o proprietário especificado. (Herdado de CommonDialog)
ToString()	Fornece uma versão string deste objeto. (Herdado de FileDialog)

evento

Name	Description
Disposed	Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component)
FileOk	Ocorre quando o utilizador clica no botão Abrir ou Guardar numa caixa de diálogo de ficheiros. (Herdado de FileDialog)
HelpRequest	Ocorre quando o utilizador clica no botão Ajuda numa caixa de diálogo comum. (Herdado de CommonDialog)

Aplica-se a

Ver também

Comentários

Esta página foi útil?