SaveFileDialog 類別

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

提示使用者選取儲存檔案的位置。 此類別無法獲得繼承。

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

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

type SaveFileDialog = class
    inherit FileDialog

Public NotInheritable Class SaveFileDialog
Inherits FileDialog

繼承

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

SaveFileDialog

範例

下列程式碼範例說明如何 SaveFileDialog 建立 、設定成員、使用 ShowDialog 方法呼叫對話方塊，以及儲存目前的檔案。 此範例需要具有放置按鈕的表單。

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      SaveFileDialog^ saveFileDialog1 = gcnew SaveFileDialog;
      saveFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      saveFileDialog1->FilterIndex = 2;
      saveFileDialog1->RestoreDirectory = true;
      if ( saveFileDialog1->ShowDialog() == ::DialogResult::OK )
      {
         if ( (myStream = saveFileDialog1->OpenFile()) != nullptr )
         {
            
            // Code to write the stream goes here.
            myStream->Close();
         }
      }
   }

private void button1_Click(object sender, System.EventArgs e)
 {
     Stream myStream ;
     SaveFileDialog saveFileDialog1 = new SaveFileDialog();
 
     saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"  ;
     saveFileDialog1.FilterIndex = 2 ;
     saveFileDialog1.RestoreDirectory = true ;
 
     if(saveFileDialog1.ShowDialog() == DialogResult.OK)
     {
         if((myStream = saveFileDialog1.OpenFile()) != null)
         {
             // Code to write the stream goes here.
             myStream.Close();
         }
     }
 }

Private Sub button1_Click(sender As Object, e As System.EventArgs)
    Dim myStream As Stream
    Dim saveFileDialog1 As New SaveFileDialog()
    
    saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    saveFileDialog1.FilterIndex = 2
    saveFileDialog1.RestoreDirectory = True
    
    If saveFileDialog1.ShowDialog() = DialogResult.OK Then
        myStream = saveFileDialog1.OpenFile()
        If (myStream IsNot Nothing) Then
            ' Code to write the stream goes here.
            myStream.Close()
        End If
    End If
End Sub

備註

這個類別可以開啟並覆寫現有的檔案，或建立新的檔案。

此類別的大部分功能都位於 類別中 FileDialog 。

建構函式

SaveFileDialog()

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

屬性

AddExtension	取得或設定值，指出對話方塊是否在使用者遺漏副檔名時，自動加入檔案的副檔名。 (繼承來源 FileDialog)
AddToRecent	取得或設定值，指出對話方塊是否會將開啟或儲存的檔案新增至最近的清單。 (繼承來源 FileDialog)
AutoUpgradeEnabled	取得或設定值，指出這個 FileDialog 實例是否應該在 Windows Vista 上執行時自動升級外觀和行為。 (繼承來源 FileDialog)
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
CheckFileExists	取得或設定值，指出如果使用者指定不存在的檔名，對話方塊是否顯示警告訊息。 (繼承來源 FileDialog)
CheckPathExists	取得或設定值，指出如果使用者指定不存在的路徑，對話方塊是否顯示警告訊息。 (繼承來源 FileDialog)
CheckWriteAccess	取得或設定值，指出對話方塊是否會驗證是否成功建立指定的檔案。 如果未設定此旗標，呼叫端應用程式必須處理建立專案時所探索的錯誤，例如拒絕存取。
ClientGuid	取得或設定要與此對話方塊狀態相關聯的 GUID。 通常，如上次瀏覽的資料夾，以及對話方塊的位置及大小等狀態，會根據可執行檔的名稱來保存。 透過指定 GUID，應用程式便可以針對相同應用程式內不同版本的對話方塊 (例如匯入對話方塊與開啟對話方塊) 具有不同的保存狀態。 在應用程式未使用視覺效果樣式，或是 AutoUpgradeEnabled 已設定為 false 的情況下，將無法使用此功能。 (繼承來源 FileDialog)
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
CreatePrompt	取得或設定值，指出如果使用者指定不存在的檔案，對話方塊是否提示使用者建立檔案的使用權限。
CustomPlaces	取得此 FileDialog 執行個體的自訂位置集合。 (繼承來源 FileDialog)
DefaultExt	取得或設定預設的副檔名。 (繼承來源 FileDialog)
DereferenceLinks	取得或設定值，指出對話方塊是傳回捷徑所參照的檔案位置，還是傳回捷徑 (.lnk) 的位置。 (繼承來源 FileDialog)
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
ExpandedMode	取得或設定值，指出對話方塊是否一律在展開模式中開啟。
FileName	取得或設定含有檔案對話方塊中所選取檔名的字串。 (繼承來源 FileDialog)
FileNames	取得對話方塊中所有選取檔案的檔名。 (繼承來源 FileDialog)
Filter	取得或設定目前的檔名篩選字串，以決定出現在對話方塊中 [另存檔案類型] 或 [檔案類型] 方塊的選項。 (繼承來源 FileDialog)
FilterIndex	取得或設定檔案對話方塊中目前所選取之篩選條件的索引。 (繼承來源 FileDialog)
InitialDirectory	取得或設定檔案對話方塊所顯示的初始目錄。 (繼承來源 FileDialog)
Instance	取得應用程式的 Win32 執行個體控制代碼 (Instance Handle)。 (繼承來源 FileDialog)
OkRequiresInteraction	取得或設定值，指出是否停用對話方塊的 [確定] 按鈕，直到使用者巡覽檢視或編輯檔案名 (是否適用) 。 (繼承來源 FileDialog)
Options	取得值來初始化 FileDialog。 (繼承來源 FileDialog)
OverwritePrompt	取得或設定值，指出如果使用者指定已經存在的檔名，Save As 對話方塊是否顯示警告訊息。
RestoreDirectory	取得或設定值，指出對話方塊是否在關閉前將目錄還原至先前選取的目錄。 (繼承來源 FileDialog)
ShowHelp	取得或設定值，指出是否在 [檔案] 對話方塊中顯示 [說明] 按鈕。 (繼承來源 FileDialog)
ShowHiddenFiles	取得或設定值，指出對話方塊是否顯示隱藏和系統檔案。 (繼承來源 FileDialog)
ShowPinnedPlaces	取得或設定值，指出是否顯示檢視流覽窗格中預設顯示的專案。 (繼承來源 FileDialog)
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()	開啟含使用者選取的讀取/寫入使用權限的檔案。
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