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 == true)
{
    // 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 中宣告此 Managed 類別。

建構函式

SaveFileDialog()

初始化 SaveFileDialog 類別的新執行個體。

屬性

AddExtension	取得或設定值，指出當使用者遺漏副檔名時，檔案對話方塊是否自動加入檔案的副檔名。 (繼承來源 FileDialog)
AddToRecent	取得或設定值，指出對話框是否會將開啟或儲存的專案新增至最近的檔案清單。 (繼承來源 CommonItemDialog)
CheckFileExists	取得或設定值，指出如果使用者指定不存在的檔名，檔案對話方塊是否會顯示警告訊息。 (繼承來源 FileDialog)
CheckPathExists	取得或設定值，指定如果使用者輸入無效的路徑和檔名，是否會顯示警告訊息。 (繼承來源 FileDialog)
ClientGuid	取得或設定要與對話框保存狀態產生關聯的 GUID。 (繼承來源 CommonItemDialog)
CreatePrompt	取得或設定值，指出如果使用者指定不存在的檔案，SaveFileDialog 是否會提示使用者提供建立檔案的權限。
CreateTestFile	取得或設定值，指出對話框是否會嘗試在選取的路徑上建立測試檔案。
CustomPlaces	取得或設定檔案對話方塊的自訂位置清單。 (繼承來源 FileDialog)
DefaultDirectory	如果沒有最近使用的目錄值可用，取得或設定檔案對話框所顯示的目錄。 (繼承來源 CommonItemDialog)
DefaultExt	取得或設定值，指定用來篩選所顯示之檔案清單的預設副檔名字串。 (繼承來源 FileDialog)
DereferenceLinks	取得或設定值，指出檔案對話方塊會傳回捷徑所參照的檔案位置，還是傳回捷徑檔 (.lnk) 的位置。 (繼承來源 FileDialog)
FileName	取得或設定字串，此字串包含在檔案對話方塊中選取之檔案的完整路徑。 (繼承來源 FileDialog)
FileNames	取得陣列，其中針對所選取的每個檔案，各包含一個檔名。 (繼承來源 FileDialog)
Filter	取得或設定篩選條件字串，可決定在 OpenFileDialog 或 SaveFileDialog 中顯示的檔案類型。 (繼承來源 FileDialog)
FilterIndex	取得或設定目前在檔案對話方塊中選取之篩選條件的索引。 (繼承來源 FileDialog)
InitialDirectory	取得或設定檔案對話方塊所顯示的初始目錄。 (繼承來源 FileDialog)
Options	取得檔案對話框用於初始化的 Win32 通用檔案對話框旗標。 (繼承來源 FileDialog)
OverwritePrompt	取得或設定值，指出如果使用者指定已經存在的檔名，SaveFileDialog 是否會顯示警告訊息。
RestoreDirectory	這個屬性未實作。 (繼承來源 FileDialog)
RootDirectory	取得或設定顯示為對話框導覽根目錄的目錄。 (繼承來源 CommonItemDialog)
SafeFileName	取得僅包含所選檔案之檔名的字串。 (繼承來源 FileDialog)
SafeFileNames	取得陣列，其中針對所選取的每個檔案，各包含一個安全檔名。 (繼承來源 FileDialog)
ShowHiddenItems	取得或設定值，指出不論使用者喜好設定為何，對話框是否會顯示隱藏和系統專案。 (繼承來源 CommonItemDialog)
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()	針對使用者利用 SaveFileDialog 選取的檔名，建立讀寫檔案資料流。
Reset()	將所有 SaveFileDialog 屬性重設為預設值。
RunDialog(IntPtr)	呼叫 RunDialog(IntPtr) 以顯示衍生類別 (Derived Class) 中的檔案對話方塊，例如 OpenFileDialog 和 SaveFileDialog。 (繼承來源 FileDialog)
ShowDialog()	顯示通用對話方塊。 (繼承來源 CommonDialog)
ShowDialog(Window)	顯示通用對話方塊。 (繼承來源 CommonDialog)
ToString()	傳回表示檔案對話方塊的字串。 (繼承來源 FileDialog)

事件

FileOk

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

另請參閱

• OpenFileDialog