OpenFileDialog 类

定义

命名空间:

Microsoft.Win32

程序集:

PresentationFramework.dll

表示一个通用对话框，用户可以使用此对话框来指定一个或多个要打开的文件的文件名。

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

继承

Object

CommonDialog

CommonItemDialog

FileDialog

OpenFileDialog

示例

以下示例演示如何创建 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 == true)
{
    // 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)
AddToRecent	获取或设置一个值，该值指示对话框是将打开的项还是保存到最近的文档列表。 (继承自 CommonItemDialog)
CheckFileExists	获取或设置一个值，该值指示如果用户指定不存在的文件名，文件对话框是否显示警告。 (继承自 FileDialog)
CheckPathExists	获取或设置一个值，该值指定如果用户键入无效的路径和文件名，是否显示警告。 (继承自 FileDialog)
ClientGuid	获取或设置要与对话框的持久状态关联的 GUID。 (继承自 CommonItemDialog)
CustomPlaces	获取或设置文件对话框的自定义空间的列表。 (继承自 FileDialog)
DefaultDirectory	获取或设置文件对话框显示的目录（如果最近没有可用的目录值）。 (继承自 CommonItemDialog)
DefaultExt	获取或设置一个值，该值指定用来筛选显示的文件列表的默认扩展名字符串。 (继承自 FileDialog)
DereferenceLinks	获取或设置一个值，该值指示文件对话框是返回快捷方式引用的文件的位置，还是返回快捷方式文件 (.lnk) 的位置。 (继承自 FileDialog)
FileName	获取或设置一个字符串，其中包含在文件对话框中选定的文件的完整路径。 (继承自 FileDialog)
FileNames	获取一个数组，其中包含与每个选定文件一一对应的文件名。 (继承自 FileDialog)
Filter	获取或设置筛选器字符串，该字符串确定在 OpenFileDialog 或 SaveFileDialog 中显示的文件类型。 (继承自 FileDialog)
FilterIndex	获取或设置文件对话框中当前选定的筛选器的索引。 (继承自 FileDialog)
ForcePreviewPane	获取或设置一个选项标志，该标志指示对话框是否强制启用预览窗格。
InitialDirectory	获取或设置文件对话框显示的初始目录。 (继承自 FileDialog)
Multiselect	获取或设置一个选项，该选项指示 OpenFileDialog 是否允许用户选择多个文件。
Options	获取文件对话用于初始化的 Win32 通用文件对话标志。 (继承自 FileDialog)
ReadOnlyChecked	获取或设置一个值，该值指示是否选中 OpenFileDialog 显示的只读复选框。
RestoreDirectory	不实现此属性。 (继承自 FileDialog)
RootDirectory	获取或设置显示为对话框的导航根目录。 (继承自 CommonItemDialog)
SafeFileName	获取一个字符串，其中仅包含选定文件的文件名。 (继承自 FileDialog)
SafeFileNames	获取一个数组，其中包含与每个选定文件一一对应的安全文件名。 (继承自 FileDialog)
ShowHiddenItems	获取或设置一个值，该值指示对话框是否显示隐藏项和系统项，而不考虑用户首选项。 (继承自 CommonItemDialog)
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)
OnItemOk(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)

另请参阅

• SaveFileDialog