SaveFileDialog 類別

定義

命名空間:

Microsoft.Win32

組件:

PresentationFramework.dll

代表一個常見對話框，允許使用者指定檔案名稱以儲存檔案。 SaveFileDialog 無法被部分信任執行的應用程式使用。

public ref class SaveFileDialog sealed : Microsoft::Win32::FileDialog

public sealed class SaveFileDialog : Microsoft.Win32.FileDialog

type SaveFileDialog = class
    inherit FileDialog

Public NotInheritable Class SaveFileDialog
Inherits FileDialog

繼承

Object

CommonDialog

CommonItemDialog

FileDialog

SaveFileDialog

範例

以下範例示範如何建立 並 SaveFileDialog 處理結果。

// Configure save file dialog box
Microsoft.Win32.SaveFileDialog dlg = new Microsoft.Win32.SaveFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show save file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process save file dialog box results
if (result.Value)
{
    // Save document
    string filename = dlg.FileName;
}

' Configure save file dialog box
Dim dlg As New Microsoft.Win32.SaveFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show save file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process save file dialog box results
If result = True Then
    ' Save document
    Dim filename As String = dlg.FileName
End If

備註

你無法在 XAML 中宣告這個管理類別。

建構函式

名稱	Description
SaveFileDialog()	初始化 SaveFileDialog 類別的新執行個體。

屬性

名稱	Description
AddExtension	取得或設定一個值，指示若使用者遺漏副檔名，檔案對話框是否自動為檔名加上副檔名。 (繼承來源 FileDialog)
AddToRecent	取得或設定一個值，指示對話框是否會將正在開啟或儲存的項目加入最近文件清單。 (繼承來源 CommonItemDialog)
CheckFileExists	會取得或設定一個值，指示若使用者指定不存在的檔名，檔案對話框是否會顯示警告。 (繼承來源 FileDialog)
CheckPathExists	取得或設定一個值，指定若使用者輸入無效路徑與檔案名稱，是否會顯示警告。 (繼承來源 FileDialog)
ClientGuid	取得或設定一個 GUID，以關聯對話框的持久狀態。 (繼承來源 CommonItemDialog)
CreatePrompt	取得或設定一個值， SaveFileDialog 指示若使用者指定不存在的檔案，是否會提示使用者取得建立檔案的權限。
CreateTestFile	取得或設定一個值，指示對話框是否會在所選路徑嘗試建立測試檔案。
DefaultDirectory	若檔案對話框中沒有最近使用的目錄值可用，則會取得或設定該目錄。 (繼承來源 CommonItemDialog)
DefaultExt	取得或設定一個值，指定預設的副檔名字串，用以篩選顯示的檔案清單。 (繼承來源 FileDialog)
FileName	取得或設定包含檔案對話框中所選檔案完整路徑的字串。 (繼承來源 FileDialog)
FileNames	會得到一個陣列，每個選擇檔案都包含一個檔案名稱。 (繼承來源 FileDialog)
Filter	取得或設定過濾字串，決定從 或 OpenFileDialog中顯示SaveFileDialog哪些類型的檔案。 (繼承來源 FileDialog)
FilterIndex	取得或設定目前在檔案對話框中選取的過濾器索引。 (繼承來源 FileDialog)
OverwritePrompt	取得或設定一個值，指示 SaveFileDialog 若使用者指定已存在檔案名稱，是否會顯示警告。
RestoreDirectory	此特性未被實作。 (繼承來源 FileDialog)
RootDirectory	取得或設定顯示為對話框導航根的目錄。 (繼承來源 CommonItemDialog)
SafeFileName	會得到一個只包含所選檔案檔名的字串。 (繼承來源 FileDialog)
SafeFileNames	會獲得一個陣列，每個選擇的檔案都包含一個安全的檔案名稱。 (繼承來源 FileDialog)
ShowHiddenItems	會取得或設定一個值，指示對話框是否會顯示隱藏項目與系統項目，無論使用者偏好如何。 (繼承來源 CommonItemDialog)
Tag	取得或設定與對話對話相關聯的物件。 這提供了將任意物件附加到對話框的功能。 (繼承來源 CommonDialog)

方法

名稱	Description
CheckPermissionsToShowDialog()	判斷是否有足夠的權限顯示對話對話。 (繼承來源 CommonDialog)
OnItemOk(CancelEventArgs)	引發 FileOk 事件。 (繼承來源 FileDialog)
OpenFile()	為使用者 SaveFileDialog所選擇的檔名建立一個讀寫檔案串流。
Reset()	將所有 SaveFileDialog 屬性重置為預設值。
ShowDialog()	顯示共同對話。 (繼承來源 CommonDialog)
ShowDialog(Window)	顯示共同對話。 (繼承來源 CommonDialog)
ToString()	回傳一個字串，代表檔案對話框。 (繼承來源 FileDialog)

事件

名稱	Description
FileOk	當使用者點擊 的OpenFileDialog按鈕或儲存SaveFileDialog按鈕選擇檔案名稱時，會發生。 (繼承來源 FileDialog)

另請參閱

• OpenFileDialog