SaveFileDialog 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提示使用者選取儲存檔案的位置。 此類別無法獲得繼承。
public ref class SaveFileDialog sealed : System::Windows::Forms::FileDialogpublic sealed class SaveFileDialog : System.Windows.Forms.FileDialogtype SaveFileDialog = class
inherit FileDialogPublic NotInheritable Class SaveFileDialog
Inherits FileDialog- 繼承
範例
下列程式碼範例說明如何 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 已設定為 |
| 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 |
取得或設定值，指出如果使用者指定已經存在的檔名， |
| RestoreDirectory |
取得或設定值，指出對話方塊是否在關閉前將目錄還原至先前選取的目錄。 (繼承來源 FileDialog) |
| ShowHelp |
取得或設定值，指出是否在 [檔案] 對話方塊中顯示 [說明] 按鈕。 (繼承來源 FileDialog) |
| ShowHiddenFiles |
取得或設定值，指出對話方塊是否顯示隱藏和系統檔案。 (繼承來源 FileDialog) |
| ShowPinnedPlaces |
取得或設定值，指出是否顯示檢視流覽窗格中預設顯示的專案。 (繼承來源 FileDialog) |
| Site | (繼承來源 Component) |
| SupportMultiDottedExtensions |
取得或設定對話方塊是否支援顯示和儲存具有多個副檔名的檔案。 (繼承來源 FileDialog) |
| Tag |
取得或設定包含控制項相關資料的物件。 (繼承來源 CommonDialog) |
| Title |
取得或設定檔案對話方塊的標題。 (繼承來源 FileDialog) |
| ValidateNames |
取得或設定值，指出對話方塊是否只接受有效的 Win32 檔名。 (繼承來源 FileDialog) |
方法
事件
| Disposed |
當 Dispose() 方法的呼叫處置元件時，就會發生。 (繼承來源 Component) |
| FileOk |
發生於使用者按一下 [檔案] 對話方塊上的 [開啟] 或 [儲存] 按鈕時。 (繼承來源 FileDialog) |
| HelpRequest |
發生於使用者按一下通用對話方塊上的 [說明] 按鈕時。 (繼承來源 CommonDialog) |
