SaveFileDialog 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.

Solicita ao utilizador que selecione um local para guardar um ficheiro. Esta classe não pode ser herdada.

public ref class SaveFileDialog sealed : System::Windows::Forms::FileDialog

public sealed class SaveFileDialog : System.Windows.Forms.FileDialog

type SaveFileDialog = class
    inherit FileDialog

Public NotInheritable Class SaveFileDialog
Inherits FileDialog

Herança: Object

MarshalByRefObject

Component

CommonDialog

FileDialog
SaveFileDialog

Exemplos

O exemplo de código seguinte ilustra a criação de um SaveFileDialog, definindo membros, chamando a caixa de diálogo usando o ShowDialog método e guardando o ficheiro atual. O exemplo requer um formulário com um botão colocado.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      SaveFileDialog^ saveFileDialog1 = gcnew SaveFileDialog;
      saveFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      saveFileDialog1->FilterIndex = 2;
      saveFileDialog1->RestoreDirectory = true;
      if ( saveFileDialog1->ShowDialog() == ::DialogResult::OK )
      {
         if ( (myStream = saveFileDialog1->OpenFile()) != nullptr )
         {
            
            // Code to write the stream goes here.
            myStream->Close();
         }
      }
   }

private void button1_Click(object sender, System.EventArgs e)
 {
     Stream myStream ;
     SaveFileDialog saveFileDialog1 = new SaveFileDialog();
 
     saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"  ;
     saveFileDialog1.FilterIndex = 2 ;
     saveFileDialog1.RestoreDirectory = true ;
 
     if(saveFileDialog1.ShowDialog() == DialogResult.OK)
     {
         if((myStream = saveFileDialog1.OpenFile()) != null)
         {
             // Code to write the stream goes here.
             myStream.Close();
         }
     }
 }

Private Sub button1_Click(sender As Object, e As System.EventArgs)
    Dim myStream As Stream
    Dim saveFileDialog1 As New SaveFileDialog()
    
    saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    saveFileDialog1.FilterIndex = 2
    saveFileDialog1.RestoreDirectory = True
    
    If saveFileDialog1.ShowDialog() = DialogResult.OK Then
        myStream = saveFileDialog1.OpenFile()
        If (myStream IsNot Nothing) Then
            ' Code to write the stream goes here.
            myStream.Close()
        End If
    End If
End Sub

Observações

Esta classe pode abrir e sobrescrever um ficheiro existente ou criar um novo ficheiro.

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

Construtores

Name	Description
SaveFileDialog()	Inicializa uma nova instância desta 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. (Herdado de FileDialog)
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)
CreatePrompt	Recebe ou define um valor que indica se a caixa de diálogo pede permissão ao utilizador para criar um ficheiro caso o utilizador especifice um ficheiro que não existe.
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)
Options	Obtém valores para inicializar o FileDialog. (Herdado de FileDialog)
OverwritePrompt	Recebe ou define um valor que indica se a `Save As` caixa de diálogo apresenta um aviso se o utilizador especificar um nome de ficheiro que já existe.
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)
ShowHelp	Recebe ou define um valor que indica se o botão Ajuda é exibido na caixa de diálogo do ficheiro. (Herdado de FileDialog)
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 com permissão de leitura/escrita selecionada pelo utilizador.
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 opções das caixas de diálogo para os 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?