SaveFileDialog 类

定义

命名空间:

Microsoft.Win32

程序集:

PresentationFramework.dll

表示一个通用对话框，用户可以使用此对话框来指定一个要将文件另存为的文件名。 在部分信任情况下执行的应用程序不能使用 SaveFileDialog。

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

继承

Object

CommonDialog

CommonItemDialog

FileDialog

SaveFileDialog

示例

以下示例演示如何创建 SaveFileDialog 并处理结果。

// 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

注解

不能在 XAML 中声明此托管类。

构造函数

SaveFileDialog()

初始化 SaveFileDialog 类的新实例。

属性

AddExtension	获取或设置一个值，该值指示如果用户省略扩展名，文件对话框是否自动在文件名中添加扩展名。 (继承自 FileDialog)
AddToRecent	获取或设置一个值，该值指示对话框是将打开或保存的项添加到最近使用的文档列表。 (继承自 CommonItemDialog)
CheckFileExists	获取或设置一个值，该值指示如果用户指定不存在的文件名，文件对话框是否显示警告。 (继承自 FileDialog)
CheckPathExists	获取或设置一个值，该值指定如果用户键入无效的路径和文件名，是否显示警告。 (继承自 FileDialog)
ClientGuid	获取或设置与对话框的持久状态关联的 GUID。 (继承自 CommonItemDialog)
CreatePrompt	获取或设置一个值，该值指示如果用户指定一个不存在的文件，SaveFileDialog 是否提示用户以允许创建文件。
CreateTestFile	获取或设置一个值，该值指示对话框是否会尝试在所选路径处创建测试文件。
CustomPlaces	获取或设置文件对话框的自定义空间的列表。 (继承自 FileDialog)
DefaultDirectory	如果最近使用的目录值不可用，则获取或设置文件对话框显示的目录。 (继承自 CommonItemDialog)
DefaultExt	获取或设置一个值，该值指定用来筛选显示的文件列表的默认扩展名字符串。 (继承自 FileDialog)
DereferenceLinks	获取或设置一个值，该值指示文件对话框是返回快捷方式引用的文件的位置，还是返回快捷方式文件 (.lnk) 的位置。 (继承自 FileDialog)
FileName	获取或设置一个字符串，其中包含在文件对话框中选定的文件的完整路径。 (继承自 FileDialog)
FileNames	获取一个数组，其中包含与每个选定文件一一对应的文件名。 (继承自 FileDialog)
Filter	获取或设置筛选器字符串，该字符串确定在 OpenFileDialog 或 SaveFileDialog 中显示的文件类型。 (继承自 FileDialog)
FilterIndex	获取或设置文件对话框中当前选定的筛选器的索引。 (继承自 FileDialog)
InitialDirectory	获取或设置文件对话框显示的初始目录。 (继承自 FileDialog)
Options	获取文件对话用于初始化的 Win32 通用文件对话标志。 (继承自 FileDialog)
OverwritePrompt	获取或设置一个值，该值指示如果用户指定的文件名已存在，SaveFileDialog 是否显示警告。
RestoreDirectory	不实现此属性。 (继承自 FileDialog)
RootDirectory	获取或设置显示为对话框导航根目录的目录。 (继承自 CommonItemDialog)
SafeFileName	获取一个字符串，其中仅包含选定文件的文件名。 (继承自 FileDialog)
SafeFileNames	获取一个数组，其中包含与每个选定文件一一对应的安全文件名。 (继承自 FileDialog)
ShowHiddenItems	获取或设置一个值，该值指示无论用户首选项如何，对话框是否将显示隐藏项和系统项。 (继承自 CommonItemDialog)
Tag	获取或设置与对话框关联的对象。 这将提供向对话框附加任意对象的能力。 (继承自 CommonDialog)
Title	获取或设置在文件对话框的标题栏中显示的文本。 (继承自 FileDialog)
ValidateNames	获取或设置一个值，该值指示对话框是否只接受有效的 Win32 文件名。 (继承自 FileDialog)

方法

CheckPermissionsToShowDialog()	确定是否有足够的权限来显示对话框。 (继承自 CommonDialog)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	定义要重写的通用文件对话框挂钩过程，以便向文件对话框添加通用功能。 (继承自 FileDialog)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnFileOk(CancelEventArgs)	引发 FileOk 事件。 (继承自 FileDialog)
OnItemOk(CancelEventArgs)	引发 FileOk 事件。 (继承自 FileDialog)
OpenFile()	为用户使用 SaveFileDialog 选定的文件名创建读/写文件流。
Reset()	将所有 SaveFileDialog 属性重置为其默认值。
RunDialog(IntPtr)	调用 RunDialog(IntPtr) 以在派生类中显示文件对话框，如 OpenFileDialog 和 SaveFileDialog。 (继承自 FileDialog)
ShowDialog()	显示通用对话框。 (继承自 CommonDialog)
ShowDialog(Window)	显示通用对话框。 (继承自 CommonDialog)
ToString()	返回表示文件对话框的字符串。 (继承自 FileDialog)

事件

FileOk

当用户通过单击 OpenFileDialog 的“打开”按钮或 SaveFileDialog 的“保存”按钮选择某个文件名时发生。 (继承自 FileDialog)

另请参阅

• OpenFileDialog