Bagikan melalui


SaveFileDialog Kelas

Definisi

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

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()
Kedaluwarsa.

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()
Kedaluwarsa.

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)

Berlaku untuk

Lihat juga