Bagikan melalui

Objek My.Forms

Menyediakan properti untuk mengakses instans setiap formulir Windows yang dideklarasikan dalam proyek saat ini.

Komentar

Objek My.Forms menyediakan instans dari setiap formulir dalam proyek saat ini. Nama properti sama dengan nama formulir yang diakses properti.

Anda dapat mengakses formulir yang disediakan oleh My.Forms objek dengan menggunakan nama formulir, tanpa kualifikasi. Karena nama properti sama dengan nama jenis formulir, ini memungkinkan Anda mengakses formulir seolah-olah memiliki instans default. Misalnya, My.Forms.Form1.Show setara dengan Form1.Show.

Objek My.Forms hanya mengekspos formulir yang terkait dengan proyek saat ini. Ini tidak menyediakan akses ke formulir yang dideklarasikan dalam DLL yang direferensikan. Untuk mengakses formulir yang disediakan DLL, Anda harus menggunakan nama formulir yang memenuhi syarat, ditulis sebagai DllName. FormName.

Anda dapat menggunakan OpenForms properti untuk mendapatkan koleksi semua formulir terbuka aplikasi.

Objek dan propertinya hanya tersedia untuk aplikasi Windows.

Karakteristik

Setiap properti My.Forms objek menyediakan akses ke instans formulir dalam proyek saat ini. Nama properti sama dengan nama formulir yang diakses properti, dan jenis properti sama dengan jenis formulir.

Nota

Jika ada tabrakan nama, nama properti untuk mengakses formulir adalah RootNamespace_Namespace_FormName. Misalnya, pertimbangkan dua formulir bernama Form1.Jika salah satu formulir ini berada di namespace WindowsApplication1 layanan akar dan di namespace Namespace1, Anda akan mengakses formulir tersebut melalui My.Forms.WindowsApplication1_Namespace1_Form1.

Objek My.Forms menyediakan akses ke instans formulir utama aplikasi yang dibuat saat startup. Untuk semua formulir lainnya, My.Forms objek membuat instans baru formulir saat diakses dan menyimpannya. Upaya berikutnya untuk mengakses properti tersebut mengembalikan instans formulir tersebut.

Anda dapat membuang formulir dengan menetapkan Nothing ke properti untuk formulir tersebut. Setter properti memanggil Close metode formulir, lalu menetapkan ke nilai tersimpan Nothing . Jika Anda menetapkan nilai apa pun selain Nothing ke properti , setter akan melemparkan ArgumentException pengecualian.

Anda dapat menguji apakah properti My.Forms objek menyimpan instans formulir dengan menggunakan Is operator atau IsNot . Anda dapat menggunakan operator tersebut untuk memeriksa apakah nilai properti adalah Nothing.

Nota

Biasanya, Is operator atau IsNot harus membaca nilai properti untuk melakukan perbandingan. Namun, jika properti saat ini menyimpan Nothing, properti membuat instans baru formulir lalu mengembalikan instans tersebut. Namun, pengkompilasi Visual Basic memperlakukan properti My.Forms objek secara berbeda dan memungkinkan Is operator atau IsNot untuk memeriksa status properti tanpa mengubah nilainya.

Contoh

Contoh ini mengubah judul formulir default SidebarMenu .

Sub ShowSidebarMenu(ByVal newTitle As String)
    If My.Forms.SidebarMenu IsNot Nothing Then
        My.Forms.SidebarMenu.Text = newTitle
    End If
End Sub

Agar contoh ini berfungsi, proyek Anda harus memiliki formulir bernama SidebarMenu.

Kode ini hanya akan berfungsi dalam proyek Aplikasi Windows.

Persyaratan

Ketersediaan menurut Jenis Proyek

Jenis proyek Tersedia
Aplikasi Windows Ya
Pustaka Kelas Tidak.
Aplikasi Konsol Tidak.
Pustaka Kontrol Windows Tidak.
Perpustakaan Kontrol Situs Web Tidak.
Layanan Windows Tidak.
Situs Web Tidak.

Lihat juga

  • Last updated on