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 中宣告這個 Managed 類別。

建構函式

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)	定義為了將通用功能加入檔案對話方塊中，而覆寫的通用檔案對話方塊攔截程序 (Hook Procedure)。 (繼承來源 FileDialog)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnFileOk(CancelEventArgs)	引發 FileOk 事件。 (繼承來源 FileDialog)
OnItemOk(CancelEventArgs)	引發 FileOk 事件。 (繼承來源 FileDialog)
OpenFile()	開啟使用者利用 OpenFileDialog 選取之檔案的唯讀資料流。
OpenFiles()	建立陣列，其中包含使用者利用 OpenFileDialog 選取之各個檔案的單一唯讀資料流。
Reset()	將所有 OpenFileDialog 屬性重設為預設值。
RunDialog(IntPtr)	呼叫 RunDialog(IntPtr) 以顯示衍生類別 (Derived Class) 中的檔案對話方塊，例如 OpenFileDialog 和 SaveFileDialog。 (繼承來源 FileDialog)
ShowDialog()	顯示通用對話方塊。 (繼承來源 CommonDialog)
ShowDialog(Window)	顯示通用對話方塊。 (繼承來源 CommonDialog)
ToString()	傳回表示檔案對話方塊的字串。 (繼承來源 FileDialog)

事件

FileOk

當使用者按一下 OpenFileDialog 的 [開啟] 按鈕或 SaveFileDialog 的 [儲存] 按鈕來選取檔案名稱時發生。 (繼承來源 FileDialog)

另請參閱

• SaveFileDialog