SaveFileDialog Classe

Definição

Namespace:

Microsoft.Win32

Assembly:

PresentationFramework.dll

Representa uma caixa de diálogo comum que permite que o usuário especifique um nome de arquivo para salvar um arquivo como. SaveFileDialog não pode ser usado por um aplicativo que está sendo executado sob confiança parcial.

public ref class SaveFileDialog sealed : Microsoft::Win32::FileDialog

public sealed class SaveFileDialog : Microsoft.Win32.FileDialog

type SaveFileDialog = class
    inherit FileDialog

Public NotInheritable Class SaveFileDialog
Inherits FileDialog

Herança

Object

CommonDialog

FileDialog

SaveFileDialog

Exemplos

O exemplo a seguir demonstra como criar e SaveFileDialog processar o resultado.

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

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

// Process save file dialog box results
if (result.Value)
{
    // Save document
    string filename = dlg.FileName;
}

' Configure save file dialog box
Dim dlg As New Microsoft.Win32.SaveFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

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

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

Comentários

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

Construtores

Nome	Description
SaveFileDialog()	Inicializa uma nova instância da classe SaveFileDialog.

Propriedades

Nome	Description
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)
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 são exibidos se o usuário digita caminhos e nomes de arquivo inválidos. (Herdado de FileDialog)
CreatePrompt	Obtém ou define um valor que indica se SaveFileDialog solicita ao usuário permissão para criar um arquivo se o usuário especificar um arquivo que não existe.
CustomPlaces	Obtém ou define a lista de locais personalizados para caixas de diálogo de arquivo. (Herdado de FileDialog)
DefaultExt	Obtém ou define um valor que especifica a cadeia de caracteres de extensão padrão a ser usada para filtrar a lista de arquivos exibidos. (Herdado de FileDialog)
DereferenceLinks	Obtém ou define um valor que indica se uma caixa de diálogo de arquivo retorna o local do arquivo referenciado por um 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 quais tipos de arquivos são exibidos do OpenFileDialog ou SaveFileDialog. (Herdado de FileDialog)
FilterIndex	Obtém ou define o índice do filtro atualmente selecionado em uma caixa de diálogo de arquivo. (Herdado de FileDialog)
InitialDirectory	Obtém ou define o diretório inicial exibido por uma caixa de diálogo de arquivo. (Herdado de FileDialog)
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)
OverwritePrompt	Obtém ou define um valor que indica se SaveFileDialog exibe um aviso se o usuário especifica o nome de um arquivo que já existe.
RestoreDirectory	Essa propriedade não é implementada. (Herdado de FileDialog)
SafeFileName	Obtém uma cadeia de caracteres que contém apenas o nome do 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)
Tag	Obtém ou define um objeto associado à 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

Nome	Description
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 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 de gancho de caixa de diálogo de arquivo comum que é substituído para adicionar funcionalidade comum a uma caixa de diálogo de arquivo. (Herdado de FileDialog)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnFileOk(CancelEventArgs)	Aciona o evento FileOk. (Herdado de FileDialog)
OpenFile()	Cria um fluxo de arquivo de leitura/gravação para o nome de arquivo selecionado pelo usuário usando SaveFileDialog.
Reset()	Redefine todas as SaveFileDialog propriedades para seus valores padrão.
RunDialog(IntPtr)	RunDialog(IntPtr) é chamado para exibir uma caixa de diálogo de arquivo em uma classe derivada, 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 de arquivo. (Herdado de FileDialog)

Eventos

Nome	Description
FileOk	Ocorre quando o usuário seleciona um nome de arquivo clicando no botão Abrir ou OpenFileDialog no botão Salvar do SaveFileDialog. (Herdado de FileDialog)

Confira também

• OpenFileDialog