SaveFileDialog 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示一个公共对话框,允许用户指定文件名以将文件另存为。 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 和处理结果。
// 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
注解
不能在 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) 调用 以在派生类中显示文件对话框,例如 OpenFileDialog 和 SaveFileDialog。 (继承自 FileDialog) |
| ShowDialog() |
显示一个常见对话框。 (继承自 CommonDialog) |
| ShowDialog(Window) |
显示一个常见对话框。 (继承自 CommonDialog) |
| ToString() |
返回表示文件对话框的字符串。 (继承自 FileDialog) |
活动
| 名称 | 说明 |
|---|---|
| FileOk |
当用户通过单击 的OpenFileDialog”按钮或 的“SaveFileDialog”按钮选择文件名时发生。 (继承自 FileDialog) |