OpenFileDialog Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menampilkan kotak dialog standar yang meminta pengguna untuk membuka file. Kelas ini tidak dapat diwariskan.

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

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

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Warisan

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

Contoh

Contoh kode berikut membuat OpenFileDialog, mengatur beberapa properti untuk menentukan filter ekstensi file dan perilaku dialog, dan menampilkan kotak dialog menggunakan CommonDialog.ShowDialog metode . Contohnya memerlukan formulir dengan ditempatkan Button di atasnya dan referensi ke namespace yang System.IO ditambahkan ke dalamnya.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;

      openFileDialog1->InitialDirectory = "c:\\";
      openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      openFileDialog1->FilterIndex = 2;
      openFileDialog1->RestoreDirectory = true;

      if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

var fileContent = string.Empty;
var filePath = string.Empty;

using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
    openFileDialog.InitialDirectory = "c:\\";
    openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
    openFileDialog.FilterIndex = 2;
    openFileDialog.RestoreDirectory = true;

    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        //Get the path of specified file
        filePath = openFileDialog.FileName;

        //Read the contents of the file into a stream
        var fileStream = openFileDialog.OpenFile();

        using (StreamReader reader = new StreamReader(fileStream))
        {
            fileContent = reader.ReadToEnd();
        }
    }
}

MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);

Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim myStream As Stream = Nothing
    Dim openFileDialog1 As New OpenFileDialog()

    openFileDialog1.InitialDirectory = "c:\"
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    openFileDialog1.FilterIndex = 2
    openFileDialog1.RestoreDirectory = True

    If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
        Try
            myStream = openFileDialog1.OpenFile()
            If (myStream IsNot Nothing) Then
                ' Insert code to read the stream here.
            End If
        Catch Ex As Exception
            MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
        Finally
            ' Check this again, since we need to make sure we didn't throw an exception on open.
            If (myStream IsNot Nothing) Then
                myStream.Close()
            End If
        End Try
    End If
End Sub

Keterangan

Kelas ini memungkinkan Anda untuk memeriksa apakah ada file dan membukanya. Properti ShowReadOnly menentukan apakah kotak centang baca-saja muncul dalam kotak dialog. Properti ReadOnlyChecked menunjukkan apakah kotak centang baca-saja dicentang.

Sebagian besar fungsi inti untuk kelas ini ditemukan di FileDialog kelas .

Pada sistem operasi kanan-ke-kiri, atur properti formulir RightToLeft yang berisi untuk RightToLeft.Yes melokalisasi tombol Nama File, Buka, dan Batal dialog. Jika properti tidak diatur ke RightToLeft.Yes, teks bahasa Inggris digunakan sebagai gantinya.

Jika Anda ingin memberi pengguna kemampuan untuk memilih folder alih-alih file, gunakan FolderBrowserDialog sebagai gantinya.

Konstruktor

OpenFileDialog()

Menginisialisasi instans OpenFileDialog kelas.

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 sedang dibuka atau disimpan ke daftar terbaru. (Diperoleh dari FileDialog)
AutoUpgradeEnabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah instans ini FileDialog harus secara otomatis meningkatkan tampilan 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.
CheckPathExists	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog menampilkan peringatan jika pengguna menentukan jalur yang tidak ada. (Diperoleh dari FileDialog)
ClientGuid	Mendapatkan atau mengatur GUID untuk dikaitkan dengan status dialog ini. Biasanya, status seperti folder terakhir yang dikunjungi dan posisi dan ukuran dialog tetap ada 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)
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)
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)
Multiselect	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog memungkinkan beberapa file dipilih.
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)
ReadOnlyChecked	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak centang baca-saja dipilih.
RestoreDirectory	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog memulihkan direktori ke direktori yang dipilih sebelumnya sebelum ditutup. (Diperoleh dari FileDialog)
SafeFileName	Mendapatkan nama file dan ekstensi untuk file yang dipilih dalam kotak dialog. Nama file tidak menyertakan jalur.
SafeFileNames	Mendapatkan array nama file dan ekstensi untuk semua file yang dipilih dalam kotak dialog. Nama file tidak menyertakan jalur.
SelectReadOnly	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog memungkinkan pemilihan file baca-saja.
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)
ShowPreview	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog memperlihatkan pratinjau untuk file yang dipilih.
ShowReadOnly	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog berisi kotak centang baca-saja.
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 menetapkan 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 digunakan oleh Component 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 dari 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 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 yang dipilih oleh pengguna, dengan izin baca-saja. File ditentukan oleh FileName properti .
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 properti 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 untai (karakter) 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
• SaveFileDialog
• Cara: Membaca Teks dari File