SaveFileDialog Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Meminta pengguna untuk memilih lokasi untuk menyimpan file. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

SaveFileDialog

Contoh

Contoh kode berikut mengilustrasikan pembuatan SaveFileDialog, mengatur anggota, memanggil kotak dialog menggunakan ShowDialog metode , dan menyimpan file saat ini. Contohnya memerlukan formulir dengan tombol yang ditempatkan di atasnya.

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

Keterangan

Kelas ini dapat membuka dan menimpa file yang ada atau membuat file baru.

Sebagian besar fungsionalitas untuk kelas ini ditemukan di FileDialog kelas .

Konstruktor

SaveFileDialog()

Menginisialisasi instans baru kelas ini.

Properti

AddExtension	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog secara otomatis menambahkan ekstensi ke nama file jika pengguna menghilangkan ekstensi. (Diperoleh dari FileDialog)
AddToRecent	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog menambahkan file yang dibuka atau disimpan ke daftar terbaru. (Diperoleh dari FileDialog)
AutoUpgradeEnabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah instans ini FileDialog harus secara otomatis meningkatkan penampilan dan perilaku saat berjalan di Windows Vista. (Diperoleh dari FileDialog)
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
CheckFileExists	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog menampilkan peringatan jika pengguna menentukan nama file yang tidak ada. (Diperoleh dari FileDialog)
CheckPathExists	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog menampilkan peringatan jika pengguna menentukan jalur yang tidak ada. (Diperoleh dari FileDialog)
CheckWriteAccess	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kotak dialog memverifikasi apakah pembuatan file yang ditentukan akan berhasil. Jika bendera ini tidak diatur, aplikasi panggilan harus menangani kesalahan, seperti penolakan akses, yang ditemukan saat item dibuat.
ClientGuid	Mendapatkan atau mengatur GUID untuk dikaitkan dengan status dialog ini. Biasanya, status seperti folder terakhir yang dikunjungi dan posisi dan ukuran dialog dipertahankan berdasarkan nama file yang dapat dieksekusi. Dengan menentukan GUID, aplikasi dapat memiliki status persisten yang berbeda untuk versi dialog yang berbeda dalam aplikasi yang sama (misalnya, dialog impor dan dialog terbuka). Fungsionalitas ini tidak tersedia jika aplikasi tidak menggunakan gaya visual atau jika AutoUpgradeEnabled diatur ke false. (Diperoleh dari FileDialog)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
CreatePrompt	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog meminta izin kepada pengguna untuk membuat file jika pengguna menentukan file yang tidak ada.
CustomPlaces	Mendapatkan koleksi tempat kustom untuk instans ini FileDialog . (Diperoleh dari FileDialog)
DefaultExt	Mendapatkan atau mengatur ekstensi nama file default. (Diperoleh dari FileDialog)
DereferenceLinks	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog mengembalikan lokasi file yang dirujuk oleh pintasan atau apakah mengembalikan lokasi pintasan (.lnk). (Diperoleh dari FileDialog)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
ExpandedMode	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog selalu dibuka dalam mode yang diperluas.
FileName	Mendapatkan atau mengatur string yang berisi nama file yang dipilih dalam kotak dialog file. (Diperoleh dari FileDialog)
FileNames	Mendapatkan nama file dari semua file yang dipilih dalam kotak dialog. (Diperoleh dari FileDialog)
Filter	Mendapatkan atau mengatur string filter nama file saat ini, yang menentukan pilihan yang muncul dalam kotak "Simpan sebagai jenis file" atau "File jenis" dalam kotak dialog. (Diperoleh dari FileDialog)
FilterIndex	Mendapatkan atau mengatur indeks filter yang saat ini dipilih dalam kotak dialog file. (Diperoleh dari FileDialog)
InitialDirectory	Mendapatkan atau mengatur direktori awal yang ditampilkan oleh kotak dialog file. (Diperoleh dari FileDialog)
Instance	Mendapatkan handel instans Win32 untuk aplikasi. (Diperoleh dari FileDialog)
OkRequiresInteraction	Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol OK kotak dialog dinonaktifkan hingga pengguna menavigasi tampilan atau mengedit nama file (jika ada). (Diperoleh dari FileDialog)
Options	Mendapatkan nilai untuk menginisialisasi FileDialog. (Diperoleh dari FileDialog)
OverwritePrompt	Mendapatkan atau mengatur nilai yang menunjukkan apakah Save As kotak dialog menampilkan peringatan jika pengguna menentukan nama file yang sudah ada.
RestoreDirectory	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog memulihkan direktori ke direktori yang dipilih sebelumnya sebelum menutup. (Diperoleh dari FileDialog)
ShowHelp	Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Bantuan ditampilkan dalam kotak dialog file. (Diperoleh dari FileDialog)
ShowHiddenFiles	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog menampilkan file tersembunyi dan sistem. (Diperoleh dari FileDialog)
ShowPinnedPlaces	Mendapatkan atau mengatur nilai yang menunjukkan apakah item yang diperlihatkan secara default di panel navigasi tampilan diperlihatkan. (Diperoleh dari FileDialog)
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
SupportMultiDottedExtensions	Mendapatkan atau mengatur apakah kotak dialog mendukung menampilkan dan menyimpan file yang memiliki beberapa ekstensi nama file. (Diperoleh dari FileDialog)
Tag	Mendapatkan atau mengatur objek yang berisi data tentang kontrol. (Diperoleh dari CommonDialog)
Title	Mendapatkan atau mengatur judul kotak dialog file. (Diperoleh dari FileDialog)
ValidateNames	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog hanya menerima nama file Win32 yang valid. (Diperoleh dari FileDialog)

Metode

CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang Component digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Menentukan prosedur kait kotak dialog umum yang ditimpa untuk menambahkan fungsionalitas tertentu ke kotak dialog file. (Diperoleh dari FileDialog)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnFileOk(CancelEventArgs)	Memunculkan kejadian FileOk. (Diperoleh dari FileDialog)
OnHelpRequest(EventArgs)	Memunculkan kejadian HelpRequest. (Diperoleh dari CommonDialog)
OpenFile()	Membuka file dengan izin baca/tulis yang dipilih oleh pengguna.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Menentukan prosedur jendela pemilik yang ditimpa untuk menambahkan fungsionalitas tertentu ke kotak dialog umum. (Diperoleh dari CommonDialog)
Reset()	Mereset semua opsi kotak dialog ke nilai defaultnya.
RunDialog(IntPtr)	Menentukan kotak dialog umum. (Diperoleh dari FileDialog)
ShowDialog()	Menjalankan kotak dialog umum dengan pemilik default. (Diperoleh dari CommonDialog)
ShowDialog(IWin32Window)	Menjalankan kotak dialog umum dengan pemilik yang ditentukan. (Diperoleh dari CommonDialog)
ToString()	Menyediakan versi string objek ini. (Diperoleh dari FileDialog)

Acara

Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
FileOk	Terjadi ketika pengguna mengklik tombol Buka atau Simpan pada kotak dialog file. (Diperoleh dari FileDialog)
HelpRequest	Terjadi ketika pengguna mengklik tombol Bantuan pada kotak dialog umum. (Diperoleh dari CommonDialog)

Lihat juga

• FileDialog
• CommonDialog