FileDialog 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
一个抽象基类，用于封装文件对话通用的功能，包括 OpenFileDialog 和 SaveFileDialog。
public ref class FileDialog abstract : Microsoft::Win32::CommonDialogpublic ref class FileDialog abstract : Microsoft::Win32::CommonItemDialogpublic abstract class FileDialog : Microsoft.Win32.CommonDialogpublic abstract class FileDialog : Microsoft.Win32.CommonItemDialogtype FileDialog = class
inherit CommonDialogtype FileDialog = class
inherit CommonItemDialogPublic MustInherit Class FileDialog
Inherits CommonDialogPublic MustInherit Class FileDialog
Inherits CommonItemDialog- 继承
- 继承
- 派生
构造函数
| 名称 | 说明 |
|---|---|
| FileDialog() |
初始化 FileDialog 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| AddExtension |
获取或设置一个值，该值指示如果用户省略扩展名，则文件对话框是否自动向文件名添加扩展名。 |
| AddToRecent |
获取或设置一个值，该值指示对话框将添加正在打开或保存到最近文档列表中的项。 (继承自 CommonItemDialog) |
| CheckFileExists |
获取或设置一个值，该值指示如果用户指定不存在的文件名，则文件对话框是否显示警告。 |
| CheckPathExists |
获取或设置一个值，该值指定当用户键入无效路径和文件名时是否显示警告。 |
| ClientGuid |
获取或设置一个 GUID 以与对话框的持久化状态相关联。 (继承自 CommonItemDialog) |
| CustomPlaces |
获取或设置文件对话框的自定义位置列表。 |
| CustomPlaces |
一个抽象基类，用于封装文件对话通用的功能，包括 OpenFileDialog 和 SaveFileDialog。 (继承自 CommonItemDialog) |
| DefaultDirectory |
获取或设置文件对话框显示的目录（如果没有最近使用的目录值可用）。 (继承自 CommonItemDialog) |
| DefaultExt |
获取或设置一个值，该值指定用于筛选显示的文件列表的默认扩展字符串。 |
| DereferenceLinks |
获取或设置一个值，该值指示文件对话框是否返回快捷方式引用的文件的位置或快捷文件的位置（.lnk）。 |
| DereferenceLinks |
获取或设置一个值，该值指示对话框是否返回快捷方式引用的文件的位置，还是返回快捷方式的位置（.lnk）。 (继承自 CommonItemDialog) |
| FileName |
获取或设置一个字符串，其中包含文件对话框中所选文件的完整路径。 |
| FileNames |
获取一个数组，其中包含每个所选文件的一个文件名。 |
| Filter |
获取或设置筛选器字符串，该字符串确定从OpenFileDialogSaveFileDialog或 .. |
| FilterIndex |
获取或设置文件对话框中当前选定的筛选器的索引。 |
| InitialDirectory |
获取或设置文件对话框显示的初始目录。 |
| InitialDirectory |
获取或设置文件对话框显示的初始目录。 (继承自 CommonItemDialog) |
| Options |
获取文件对话用于初始化的 Win32 常见文件对话标志。 |
| RestoreDirectory |
此属性未实现。 |
| RootDirectory |
获取或设置显示为对话框导航根目录的目录。 (继承自 CommonItemDialog) |
| SafeFileName |
获取一个字符串，该字符串仅包含所选文件的文件名。 |
| SafeFileNames |
获取一个数组，其中包含每个所选文件的一个安全文件名。 |
| ShowHiddenItems |
获取或设置一个值，该值指示对话框是否显示隐藏项和系统项，而不考虑用户首选项。 (继承自 CommonItemDialog) |
| Tag |
获取或设置与对话框关联的对象。 这样，就能够将任意对象附加到对话。 (继承自 CommonDialog) |
| Title |
获取或设置文件对话框标题栏中显示的文本。 |
| Title |
获取或设置文件对话框标题栏中显示的文本。 (继承自 CommonItemDialog) |
| ValidateNames |
获取或设置一个值，该值指示对话框是否只接受有效的 Win32 文件名。 |
| ValidateNames |
获取或设置一个值，该值指示检查是否存在阻止应用程序打开所选文件的情况，例如共享冲突或访问被拒绝错误。 (继承自 CommonItemDialog) |
方法
| 名称 | 说明 |
|---|---|
| CheckPermissionsToShowDialog() |
确定是否有足够的权限显示对话框。 (继承自 CommonDialog) |
| Equals(Object) |
确定指定的对象是否等于当前对象。 (继承自 Object) |
| GetHashCode() |
用作默认哈希函数。 (继承自 Object) |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
定义重写的通用文件对话挂钩过程，以便向文件对话添加通用功能。 |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
定义重写的通用对话框挂钩过程，以便向通用对话框添加特定功能。 (继承自 CommonDialog) |
| MemberwiseClone() |
创建当前 Object的浅表副本。 (继承自 Object) |
| OnFileOk(CancelEventArgs) |
引发 FileOk 事件。 |
| OnItemOk(CancelEventArgs) |
引发 FileOk 事件。 |
| Reset() |
将文件对话框的所有属性设置回其初始值。 |
| RunDialog(IntPtr) |
RunDialog(IntPtr) 调用 以在派生类中显示文件对话框，例如 OpenFileDialog 和 SaveFileDialog。 |
| RunDialog(IntPtr) |
执行初始化工作，以便显示文件打开、文件保存或文件夹打开对话框。 (继承自 CommonItemDialog) |
| ShowDialog() |
显示一个常见对话框。 (继承自 CommonDialog) |
| ShowDialog(Window) |
显示一个常见对话框。 (继承自 CommonDialog) |
| ToString() |
返回表示文件对话框的字符串。 |
活动
| 名称 | 说明 |
|---|---|
| FileOk |
当用户通过单击 的OpenFileDialog”按钮或 的“SaveFileDialog”按钮选择文件名时发生。 |
