OpenFileDialog 類別

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

顯示對話方塊，以提示使用者開啟檔案。 此類別無法獲得繼承。

public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialog

public sealed class OpenFileDialog : System.Windows.Forms.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

繼承

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

範例

下列程式碼範例會建立 、設定數個 OpenFileDialog 屬性來定義副檔名篩選和對話方塊行為，並使用 方法顯示對話方塊 CommonDialog.ShowDialog 。 此範例需要一個位於它的 表單 Button ，以及新增至它的命名空間的參考 System.IO 。

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;

      openFileDialog1->InitialDirectory = "c:\\";
      openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      openFileDialog1->FilterIndex = 2;
      openFileDialog1->RestoreDirectory = true;

      if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

var fileContent = string.Empty;
var filePath = string.Empty;

using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
    openFileDialog.InitialDirectory = "c:\\";
    openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
    openFileDialog.FilterIndex = 2;
    openFileDialog.RestoreDirectory = true;

    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        //Get the path of specified file
        filePath = openFileDialog.FileName;

        //Read the contents of the file into a stream
        var fileStream = openFileDialog.OpenFile();

        using (StreamReader reader = new StreamReader(fileStream))
        {
            fileContent = reader.ReadToEnd();
        }
    }
}

MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);

Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim myStream As Stream = Nothing
    Dim openFileDialog1 As New OpenFileDialog()

    openFileDialog1.InitialDirectory = "c:\"
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    openFileDialog1.FilterIndex = 2
    openFileDialog1.RestoreDirectory = True

    If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
        Try
            myStream = openFileDialog1.OpenFile()
            If (myStream IsNot Nothing) Then
                ' Insert code to read the stream here.
            End If
        Catch Ex As Exception
            MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
        Finally
            ' Check this again, since we need to make sure we didn't throw an exception on open.
            If (myStream IsNot Nothing) Then
                myStream.Close()
            End If
        End Try
    End If
End Sub

備註

這個類別可讓您檢查檔案是否存在，並加以開啟。 屬性 ShowReadOnly 會判斷對話方塊中是否顯示唯讀核取方塊。 屬性 ReadOnlyChecked 會指出是否已核取唯讀核取方塊。

在 類別中找到 FileDialog 此類別的大部分核心功能。

在由右至左的作業系統上，將包含表單的 RightToLeft 屬性設定為 RightToLeft.Yes 當地語系化對話方塊的 [ 檔案名]、[ 開啟] 和 [ 取消] 按鈕。 如果 屬性未設定為 RightToLeft.Yes ，則會改用英文文字。

如果您想要讓使用者能夠選取資料夾而非檔案，請改用 FolderBrowserDialog 。

建構函式

OpenFileDialog()

初始化 OpenFileDialog 類別的執行個體。

屬性

AddExtension	取得或設定值，指出對話方塊是否在使用者遺漏副檔名時，自動加入檔案的副檔名。 (繼承來源 FileDialog)
AddToRecent	取得或設定值，指出對話方塊是否會將開啟或儲存的檔案新增至最近的清單。 (繼承來源 FileDialog)
AutoUpgradeEnabled	取得或設定值，指出這個 FileDialog 實例是否應該在 Windows Vista 上執行時自動升級外觀和行為。 (繼承來源 FileDialog)
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
CheckFileExists	取得或設定值，指出如果使用者指定不存在的檔名，對話方塊是否顯示警告訊息。
CheckPathExists	取得或設定值，指出如果使用者指定不存在的路徑，對話方塊是否顯示警告訊息。 (繼承來源 FileDialog)
ClientGuid	取得或設定要與此對話方塊狀態相關聯的 GUID。 通常，如上次瀏覽的資料夾，以及對話方塊的位置及大小等狀態，會根據可執行檔的名稱來保存。 透過指定 GUID，應用程式便可以針對相同應用程式內不同版本的對話方塊 (例如匯入對話方塊與開啟對話方塊) 具有不同的保存狀態。 在應用程式未使用視覺效果樣式，或是 AutoUpgradeEnabled 已設定為 false 的情況下，將無法使用此功能。 (繼承來源 FileDialog)
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
CustomPlaces	取得此 FileDialog 執行個體的自訂位置集合。 (繼承來源 FileDialog)
DefaultExt	取得或設定預設的副檔名。 (繼承來源 FileDialog)
DereferenceLinks	取得或設定值，指出對話方塊是傳回捷徑所參照的檔案位置，還是傳回捷徑 (.lnk) 的位置。 (繼承來源 FileDialog)
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
FileName	取得或設定含有檔案對話方塊中所選取檔名的字串。 (繼承來源 FileDialog)
FileNames	取得對話方塊中所有選取檔案的檔名。 (繼承來源 FileDialog)
Filter	取得或設定目前的檔名篩選字串，以決定出現在對話方塊中 [另存檔案類型] 或 [檔案類型] 方塊的選項。 (繼承來源 FileDialog)
FilterIndex	取得或設定檔案對話方塊中目前所選取之篩選條件的索引。 (繼承來源 FileDialog)
InitialDirectory	取得或設定檔案對話方塊所顯示的初始目錄。 (繼承來源 FileDialog)
Instance	取得應用程式的 Win32 執行個體控制代碼 (Instance Handle)。 (繼承來源 FileDialog)
Multiselect	取得或設定值，表示對話方塊是否允許選取多個檔案。
OkRequiresInteraction	取得或設定值，指出是否停用對話方塊的 [確定] 按鈕，直到使用者巡覽檢視或編輯檔案名 (，如果適用的話) 。 (繼承來源 FileDialog)
Options	取得值來初始化 FileDialog。 (繼承來源 FileDialog)
ReadOnlyChecked	取得或設定值，表示是否選取唯讀核取方塊。
RestoreDirectory	取得或設定值，指出對話方塊是否在關閉前將目錄還原至先前選取的目錄。 (繼承來源 FileDialog)
SafeFileName	取得對話方塊中選取之檔案的檔案名稱和副檔名。 檔案名稱不包含路徑。
SafeFileNames	取得對話方塊中所有選取檔案之檔案名稱和副檔名的陣列。 檔案名稱不包含路徑。
SelectReadOnly	取得或設定值，指出對話方塊是否允許選取唯讀檔案。
ShowHelp	取得或設定值，指出是否在 [檔案] 對話方塊中顯示 [說明] 按鈕。 (繼承來源 FileDialog)
ShowHiddenFiles	取得或設定值，指出對話方塊是否顯示隱藏和系統檔案。 (繼承來源 FileDialog)
ShowPinnedPlaces	取得或設定值，指出是否顯示檢視導覽窗格中預設顯示的專案。 (繼承來源 FileDialog)
ShowPreview	取得或設定值，指出對話方塊是否顯示所選檔案的預覽。
ShowReadOnly	取得或設定值，表示對話方塊是否包含唯讀核取方塊。
Site	取得或設定 Component 的 ISite。 (繼承來源 Component)
SupportMultiDottedExtensions	取得或設定對話方塊是否支援顯示和儲存具有多個副檔名的檔案。 (繼承來源 FileDialog)
Tag	取得或設定包含控制項相關資料的物件。 (繼承來源 CommonDialog)
Title	取得或設定檔案對話方塊的標題。 (繼承來源 FileDialog)
ValidateNames	取得或設定值，指出對話方塊是否只接受有效的 Win32 檔名。 (繼承來源 FileDialog)

方法

CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 Component 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Component)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承來源 Component)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	定義為了將特定功能加入檔案對話方塊中而覆寫的通用對話方塊攔截程序 (Hook Procedure)。 (繼承來源 FileDialog)
InitializeLifetimeService()	取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
OnFileOk(CancelEventArgs)	引發 FileOk 事件。 (繼承來源 FileDialog)
OnHelpRequest(EventArgs)	引發 HelpRequest 事件。 (繼承來源 CommonDialog)
OpenFile()	開啟使用者所選取含唯讀使用權限的檔案。 這個檔案由 FileName 屬性所指定。
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	定義為了將特定功能加入通用對話方塊中而覆寫的主控視窗 (Owner Window) 程序。 (繼承來源 CommonDialog)
Reset()	重設所有屬性為預設值。
RunDialog(IntPtr)	指定通用對話方塊。 (繼承來源 FileDialog)
ShowDialog()	以預設的擁有人來執行通用對話方塊。 (繼承來源 CommonDialog)
ShowDialog(IWin32Window)	以指定的擁有人來執行通用對話方塊。 (繼承來源 CommonDialog)
ToString()	提供這個物件的字串版本。 (繼承來源 FileDialog)

事件

Disposed	當 Dispose() 方法的呼叫處置元件時，就會發生。 (繼承來源 Component)
FileOk	發生於使用者按一下 [檔案] 對話方塊上的 [開啟] 或 [儲存] 按鈕時。 (繼承來源 FileDialog)
HelpRequest	發生於使用者按一下通用對話方塊上的 [說明] 按鈕時。 (繼承來源 CommonDialog)

另請參閱

• FileDialog
• CommonDialog
• SaveFileDialog
• 作法：讀取檔案中的文字