C#面向桌面应用开发时常用到的几种对话框的简单使用和常用属性的说明

WPF下需要引用命名空间：using System.Windows.Forms;

ColorDialog（颜色选择对话框）

表示一个通用对话框，该对话框显示可用的颜色以及允许用户定义自定义颜色的控件。

属性及方法

属性及方法名	说明
Reset()	将所有选项重新设置为其默认值，将最后选定的颜色重新设置为黑色，将自定义颜色重新设置为其默认值。
AllowFullOpen	获取或设置一个值，该值指示用户是否可以使用该对话框定义自定义颜色。
AnyColor	获取或设置一个值，该值指示对话框是否显示基本颜色集中可用的所有颜色。
Color	获取或设置用户选定的颜色
CustomColors	获取或设置对话框中显示的自定义颜色集。
FullOpen	获取或设置一个值，该值指示用于创建自定义颜色的控件在对话框打开时是否可见。
ShowHelp	获取或设置一个值，该值指示在颜色对话框中是否显示“帮助”按钮。
SolidColorOnly	获取或设置一个值，该值指示对话框是否限制用户只选择纯色。

样式

使用

System.Windows.Forms.ColorDialog dialog = new System.Windows.Forms.ColorDialog();
dialog.Color = System.Drawing.Color.OrangeRed;
dialog.ShowHelp = false;
System.Windows.Forms.DialogResult result = dialog.ShowDialog();

FolderBrowserDialog（文件夹选择对话框）

提示用户选择文件夹。无法继承此类。

属性及方法

属性及方法名	说明
Reset()	将属性重置为其默认值。
Description	获取或设置对话框中在树视图控件上显示的说明文本。
RootFolder	获取或设置从其开始浏览的根文件夹。
SelectedPath	获取或设置用户选定的路径。
ShowNewFolderButton	获取或设置一个值，该值指示“新建文件夹”按钮是否显示在文件夹浏览对话框中。

样式

使用

System.Windows.Forms.FolderBrowserDialog dialog = new System.Windows.Forms.FolderBrowserDialog();
dialog.Description = "请选择一个目录作为路径：";
dialog.ShowNewFolderButton = true;
dialog.RootFolder = Environment.SpecialFolder.ApplicationData;
System.Windows.Forms.DialogResult result = dialog.ShowDialog();

FileDialog

OpenFileDialog和SaveFileDialog都是继承于FileDialog

属性及方法

属性及方法名	说明
Reset()	将所有属性重新设置为其默认值。
Description	获取或设置对话框中在树视图控件上显示的说明文本。
AddExtension	获取或设置一个值，该值指示如果用户省略扩展名，对话框是否自动在文件名中添加扩展名。
AutoUpgradeEnabled	获取或设置一个值，该值指示此 System.Windows.Forms.FileDialog 实例在 Windows Vista 上运行时是否应自动升级外观和行为。
CheckFileExists	获取或设置一个值，该值指示如果用户指定不存在的文件名，对话框是否显示警告。
CheckPathExists	获取或设置一个值，该值指示如果用户指定不存在的路径，对话框是否显示警告。
CustomPlaces	获取此 System.Windows.Forms.FileDialog 实例的自定义空间的集合。
DefaultExt	获取或设置默认文件扩展名。配合AddExtension使用
DereferenceLinks	获取或设置一个值，该值指示对话框是否返回快捷方式引用的文件的位置，或者是否返回快捷方式 (.lnk) 的位置 。
FileName	获取或设置一个包含在文件对话框中选定的文件名的字符串。
FileNames	获取对话框中所有选定文件的文件名。
Filter	获取或设置当前文件名筛选器字符串，该字符串决定对话框的“另存为文件类型”或“文件类型”框中出现的选择内容。
FilterIndex	获取或设置文件对话框中当前选定筛选器的索引。
InitialDirectory	获取或设置文件对话框显示的初始目录。
RestoreDirectory	获取或设置一个值，该值指示对话框在关闭前是否还原当前目录。
ShowHelp	获取或设置一个值，该值指示文件对话框中是否显示“帮助”按钮。
SupportMultiDottedExtensions	获取或设置对话框是否支持显示和保存具有多个文件扩展名的文件。
Title	获取或设置文件对话框标题。
ValidateNames	获取或设置一个值，该值指示对话框是否只接受有效的 Win32 文件名。

OpenFileDialog（文件选择对话框）

提示用户打开文件。无法继承此类。

属性及方法

属性及方法名	说明
CheckFileExists	获取或设置一个值，该值指示如果用户指定不存在的文件名，对话框是否显示警告。
Multiselect	获取或设置一个值，该值指示对话框是否允许选择多个文件。
ReadOnlyChecked	获取或设置一个值，该值指示是否选定只读复选框。
SafeFileName	获取对话框中所选文件的文件名和扩展名。文件名不包含路径。
SafeFileNames	获取对话框中所有选定文件的文件名和扩展名的数组。文件名不包含路径。
ShowReadOnly	获取或设置一个值，该值指示对话框是否包含只读复选框。

样式

使用

System.Windows.Forms.OpenFileDialog dialog = new System.Windows.Forms.OpenFileDialog();
dialog.Filter = "PDF文件|*.pdf|Word 2003文件|*.doc";
System.Windows.Forms.DialogResult result = dialog.ShowDialog();
if (result == System.Windows.Forms.DialogResult.OK)
{
    string filepath = dialog.FileName;
}

SaveFileDialog（保存文件选择对话框）

提示用户选择文件的保存位置。无法继承此类。

属性及方法

属性及方法名	说明
CreatePrompt	获取或设置一个值，该值指示如果用户指定不存在的文件，对话框是否提示用户允许创建该文件。
OverwritePrompt	获取或设置一个值，该值指示如果用户指定的文件名已存在，Save As 对话框是否显示警告。

样式

使用

System.Windows.Forms.SaveFileDialog dialog = new System.Windows.Forms.SaveFileDialog();
dialog.Filter = "PDF文件|*.pdf|Word 2003文件|*.doc";
System.Windows.Forms.DialogResult result = dialog.ShowDialog();
if (result == System.Windows.Forms.DialogResult.OK)
{
    string newFilepath = dialog.FileName;
}