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- 繼承
- 繼承
- 衍生
建構函式
| 名稱 | Description |
|---|---|
| FileDialog() |
初始化 FileDialog 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| AddExtension |
取得或設定一個值，指示若使用者遺漏副檔名，檔案對話框是否自動為檔名加上副檔名。 |
| AddToRecent |
取得或設定一個值，指示對話框是否會將正在開啟或儲存的項目加入最近文件清單。 (繼承來源 CommonItemDialog) |
| CheckFileExists |
會取得或設定一個值，指示若使用者指定不存在的檔名，檔案對話框是否會顯示警告。 |
| CheckPathExists |
取得或設定一個值，指定若使用者輸入無效路徑與檔案名稱，是否會顯示警告。 |
| ClientGuid |
取得或設定一個 GUID，以關聯對話框的持久狀態。 (繼承來源 CommonItemDialog) |
| CustomPlaces |
取得或設定檔案對話框的自訂位置清單。 |
| CustomPlaces |
一個抽象基底類別，封裝了檔案對話中常見的功能，包括 OpenFileDialog 和 SaveFileDialog。 (繼承來源 CommonItemDialog) |
| DefaultDirectory |
若檔案對話框中沒有最近使用的目錄值可用，則會取得或設定該目錄。 (繼承來源 CommonItemDialog) |
| DefaultExt |
取得或設定一個值，指定預設的副檔名字串，用以篩選顯示的檔案清單。 |
| DereferenceLinks |
取得或設定一個值，指示檔案對話框是回傳捷徑所參考的檔案位置，還是捷徑檔案（.lnk）的位置。 |
| DereferenceLinks |
會取得或設定一個值，表示對話框是回傳捷徑所參考的檔案位置，還是回傳捷徑的位置（.lnk）。 (繼承來源 CommonItemDialog) |
| FileName |
取得或設定包含檔案對話框中所選檔案完整路徑的字串。 |
| FileNames |
會得到一個陣列，每個選擇檔案都包含一個檔案名稱。 |
| Filter |
取得或設定過濾字串，決定從 或 OpenFileDialog中顯示SaveFileDialog哪些類型的檔案。 |
| FilterIndex |
取得或設定目前在檔案對話框中選取的過濾器索引。 |
| InitialDirectory |
取得或設定由檔案對話框顯示的初始目錄。 |
| InitialDirectory |
取得或設定檔案對話框中顯示的初始目錄。 (繼承來源 CommonItemDialog) |
| Options |
取得 Win32 常見檔案對話框的旗標，這些標誌用於檔案對話框的初始化。 |
| RestoreDirectory |
此特性未被實作。 |
| RootDirectory |
取得或設定顯示為對話框導航根的目錄。 (繼承來源 CommonItemDialog) |
| SafeFileName |
會得到一個只包含所選檔案檔名的字串。 |
| SafeFileNames |
會獲得一個陣列，每個選擇的檔案都包含一個安全的檔案名稱。 |
| ShowHiddenItems |
會取得或設定一個值，指示對話框是否會顯示隱藏項目與系統項目，無論使用者偏好如何。 (繼承來源 CommonItemDialog) |
| Tag |
取得或設定與對話對話相關聯的物件。 這提供了將任意物件附加到對話框的功能。 (繼承來源 CommonDialog) |
| Title |
取得或設定檔案對話框標題欄中的文字。 |
| Title |
取得或設定檔案對話框標題欄中的文字。 (繼承來源 CommonItemDialog) |
| ValidateNames |
會取得或設定一個值，指示對話框是否只接受有效的 Win32 檔案名稱。 |
| ValidateNames |
取得或設定一個值，指示是否檢查會阻止應用程式開啟所選檔案的情況，例如分享違規或存取被拒絕錯誤。 (繼承來源 CommonItemDialog) |
方法
| 名稱 | Description |
|---|---|
| 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() |
回傳一個字串，代表檔案對話框。 |
事件
| 名稱 | Description |
|---|---|
| FileOk |
當使用者點擊 的OpenFileDialog按鈕或儲存SaveFileDialog按鈕選擇檔案名稱時，會發生。 |
