OpenFileDialog 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示一个通用对话框,允许用户指定一个或多个要打开的文件的文件名。
public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialog
public sealed class OpenFileDialog : Microsoft.Win32.FileDialog
type OpenFileDialog = class
inherit FileDialog
Public NotInheritable Class OpenFileDialog
Inherits FileDialog
- 继承
示例
以下示例演示如何创建 OpenFileDialog 包含默认文件名和扩展名类型的值。
// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension
// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();
// Process open file dialog box results
if (result.Value)
{
// Open document
string filename = dlg.FileName;
}
' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension
' Show open file dialog box
Dim result? As Boolean = dlg.ShowDialog()
' Process open file dialog box results
If result = True Then
' Open document
Dim filename As String = dlg.FileName
End If
注解
不能在 XAML 中声明此托管类。
构造函数
| 名称 | 说明 |
|---|---|
| OpenFileDialog() |
初始化 OpenFileDialog 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| AddExtension |
获取或设置一个值,该值指示如果用户省略扩展名,则文件对话框是否自动向文件名添加扩展名。 (继承自 FileDialog) |
| CheckFileExists |
获取或设置一个值,该值指示如果用户指定不存在的文件名,则文件对话框是否显示警告。 (继承自 FileDialog) |
| CheckPathExists |
获取或设置一个值,该值指定当用户键入无效路径和文件名时是否显示警告。 (继承自 FileDialog) |
| CustomPlaces |
获取或设置文件对话框的自定义位置列表。 (继承自 FileDialog) |
| DefaultExt |
获取或设置一个值,该值指定用于筛选显示的文件列表的默认扩展字符串。 (继承自 FileDialog) |
| DereferenceLinks |
获取或设置一个值,该值指示文件对话框是否返回快捷方式引用的文件的位置或快捷文件的位置(.lnk)。 (继承自 FileDialog) |
| FileName |
获取或设置一个字符串,其中包含文件对话框中所选文件的完整路径。 (继承自 FileDialog) |
| FileNames |
获取一个数组,其中包含每个所选文件的一个文件名。 (继承自 FileDialog) |
| Filter |
获取或设置筛选器字符串,该字符串确定从OpenFileDialogSaveFileDialog或 .. (继承自 FileDialog) |
| FilterIndex |
获取或设置文件对话框中当前选定的筛选器的索引。 (继承自 FileDialog) |
| InitialDirectory |
获取或设置文件对话框显示的初始目录。 (继承自 FileDialog) |
| Multiselect |
获取或设置一个选项,该值指示是否 OpenFileDialog 允许用户选择多个文件。 |
| Options |
获取文件对话用于初始化的 Win32 常见文件对话标志。 (继承自 FileDialog) |
| ReadOnlyChecked |
获取或设置一个值,该值指示是否选中了 OpenFileDialog 显示的只读复选框。 |
| RestoreDirectory |
此属性未实现。 (继承自 FileDialog) |
| SafeFileName |
获取一个字符串,该字符串仅包含所选文件的文件名。 (继承自 FileDialog) |
| SafeFileNames |
获取一个数组,其中包含每个所选文件的一个安全文件名。 (继承自 FileDialog) |
| ShowReadOnly |
获取或设置一个值,该值指示是否 OpenFileDialog 包含只读复选框。 |
| 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() |
为用户使用 OpenFileDialog的文件打开只读流。 |
| OpenFiles() |
创建一个数组,其中包含用户使用 OpenFileDialog的每个文件选择的一个只读流。 |
| Reset() |
将所有 OpenFileDialog 属性重置为其默认值。 |
| RunDialog(IntPtr) |
RunDialog(IntPtr) 调用 以在派生类中显示文件对话框,例如 OpenFileDialog 和 SaveFileDialog。 (继承自 FileDialog) |
| ShowDialog() |
显示一个常见对话框。 (继承自 CommonDialog) |
| ShowDialog(Window) |
显示一个常见对话框。 (继承自 CommonDialog) |
| ToString() |
返回表示文件对话框的字符串。 (继承自 FileDialog) |
活动
| 名称 | 说明 |
|---|---|
| FileOk |
当用户通过单击 的OpenFileDialog”按钮或 的“SaveFileDialog”按钮选择文件名时发生。 (继承自 FileDialog) |