Bagikan melalui


OpenFileDialog Kelas

Definisi

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

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

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)

Berlaku untuk

Lihat juga