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 com o qual um arquivo será salvo. SaveFileDialog não pode ser usado por um aplicativo executado em 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

CommonItemDialog

FileDialog

SaveFileDialog

Exemplos

O exemplo a seguir demonstra como criar um SaveFileDialog e 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 == true)
{
    // 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

SaveFileDialog()

Inicializa uma nova instância da classe SaveFileDialog.

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)
CreatePrompt	Obtém ou define um valor que indica se SaveFileDialog solicitará permissão ao usuário para criar um arquivo se o usuário especificar um arquivo inexistente.
CreateTestFile	Obtém ou define um valor que indica se a caixa de diálogo tentará criar um arquivo de teste no caminho selecionado.
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)
InitialDirectory	Obtém ou define o diretório inicial que é 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 quando o usuário especifica o nome de um arquivo que já existe.
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)
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()	Cria um fluxo de arquivos de leitura-gravação para o nome do arquivo selecionado pelo usuário usando SaveFileDialog.
Reset()	Redefine todas as propriedades SaveFileDialog 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)

Confira também

• OpenFileDialog