SaveFileDialog 类

定义

表示一个通用对话框,用户可以使用此对话框来指定一个要将文件另存为的文件名。 在部分信任情况下执行的应用程序不能使用 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
继承
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

注解

下图显示了一个SaveFileDialog适用于 Windows Vista。

“另存为”对话框

从 Windows Vista 开始,打开并保存文件对话框的左侧有一个 “收藏夹链接”面板,允许用户快速导航到其他位置。 这些链接称为自定义位置。 使用 CustomPlaces 属性设置此链接列表。

XAML 文本用法

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

构造函数

SaveFileDialog()

初始化 SaveFileDialog 类的新实例。

属性

AddExtension

获取或设置一个值,该值指示如果用户省略扩展名,文件对话框是否自动在文件名中添加扩展名。

(继承自 FileDialog)
CheckFileExists

获取或设置一个值,该值指示如果用户指定不存在的文件名,文件对话框是否显示警告。

(继承自 FileDialog)
CheckPathExists

获取或设置一个值,该值指定如果用户键入无效的路径和文件名,是否显示警告。

(继承自 FileDialog)
CreatePrompt

获取或设置一个值,该值指示如果用户指定一个不存在的文件,SaveFileDialog 是否提示用户以允许创建文件。

CustomPlaces

获取或设置文件对话框的自定义空间的列表。

(继承自 FileDialog)
DefaultExt

获取或设置一个值,该值指定用来筛选显示的文件列表的默认扩展名字符串。

(继承自 FileDialog)
DereferenceLinks

获取或设置一个值,该值指示文件对话框是返回快捷方式引用的文件的位置,还是返回快捷方式文件 (.lnk) 的位置。

(继承自 FileDialog)
FileName

获取或设置一个字符串,其中包含在文件对话框中选定的文件的完整路径。

(继承自 FileDialog)
FileNames

获取一个数组,其中包含与每个选定文件一一对应的文件名。

(继承自 FileDialog)
Filter

获取或设置筛选器字符串,该字符串确定在 OpenFileDialogSaveFileDialog 中显示的文件类型。

(继承自 FileDialog)
FilterIndex

获取或设置文件对话框中当前选定的筛选器的索引。

(继承自 FileDialog)
InitialDirectory

获取或设置文件对话框显示的初始目录。

(继承自 FileDialog)
Options

获取由文件对话用于初始化的 Win32 常见文件对话标志。

(继承自 FileDialog)
OverwritePrompt

获取或设置一个值,该值指示如果用户指定的文件名已存在,SaveFileDialog 是否显示警告。

RestoreDirectory

不实现此属性。

(继承自 FileDialog)
SafeFileName

获取一个字符串,其中仅包含选定文件的文件名。

(继承自 FileDialog)
SafeFileNames

获取一个数组,其中包含与每个选定文件一一对应的安全文件名。

(继承自 FileDialog)
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)
OpenFile()

为用户使用 SaveFileDialog 选定的文件名创建读/写文件流。

Reset()

将所有 SaveFileDialog 属性重置为其默认值。

RunDialog(IntPtr)

调用 RunDialog(IntPtr) 以在派生类中显示文件对话框,如 OpenFileDialogSaveFileDialog

(继承自 FileDialog)
ShowDialog()

显示通用对话框。

(继承自 CommonDialog)
ShowDialog(Window)

显示通用对话框。

(继承自 CommonDialog)
ToString()

返回表示文件对话框的字符串。

(继承自 FileDialog)

事件

FileOk

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

(继承自 FileDialog)

适用于

另请参阅