My.Forms Nesnesi

  • Makale

Geçerli projede bildirilen her Windows formunun bir örneğine erişmek için özellikler sağlar.

Açıklamalar

My.Forms nesnesi geçerli projedeki her formun bir örneğini sağlar. Özelliğin adı, özelliğin eriştiği formun adıyla aynıdır.

Nesne tarafından My.Forms sağlanan formlara, nitelik olmadan formun adını kullanarak erişebilirsiniz. Özellik adı formun tür adıyla aynı olduğundan, bir forma varsayılan örneği varmış gibi erişmenizi sağlar. Örneğin My.Forms.Form1.Show ile Form1.Show eşdeğerdir.

My.Forms nesnesi yalnızca geçerli projeyle ilişkili formları kullanıma sunar. Başvuruda bulunılan DLL'lerde bildirilen formlara erişim sağlamaz. DLL'nin sağladığı bir forma erişmek için, formun DllName olarak yazılmış tam adını kullanmanız gerekir.FormAdı.

özelliğini kullanarak OpenForms uygulamanın tüm açık formlarının koleksiyonunu alabilirsiniz.

Nesnesi ve özellikleri yalnızca Windows uygulamaları için kullanılabilir.

Properties

nesnesinin My.Forms her özelliği, geçerli projedeki bir formun örneğine erişim sağlar. Özelliğin adı, özelliğin eriştiği formun adıyla aynıdır ve özellik türü formun türüyle aynıdır.

Not

Ad çakışması varsa, forma erişmek için özellik adı RootNamespace_Namespace_FormName olur. Örneğin, bu formlardan biri kök ad alanında ve Namespace1ad alanındaysa WindowsApplication1 adlı Form1.iki formu göz önünde bulundurun. Bu forma aracılığıyla My.Forms.WindowsApplication1_Namespace1_Form1erişebilirsiniz.

nesnesi, My.Forms uygulamanın başlangıçta oluşturulan ana formunun örneğine erişim sağlar. Diğer tüm formlar için, My.Forms nesnesi erişildiğinde formun yeni bir örneğini oluşturur ve bunu depolar. Bu özelliğe erişmeye yönelik sonraki girişimler formun bu örneğini döndürür.

Bu formun özelliğine atayarak Nothing formu atabilirsiniz. Özellik ayarlayıcısı formun Close yöntemini çağırır ve depolanan değere atar Nothing . özelliği dışında Nothing bir değer atarsanız, ayarlayıcı bir ArgumentException özel durum oluşturur.

nesnesinin bir özelliğinin My.Forms veya IsNot işlecini kullanarak Is formun bir örneğini depolayıp depolamadığını test edebilirsiniz. Özelliğin Nothingdeğerinin olup olmadığını denetlemek için bu işleçleri kullanabilirsiniz.

Not

Genellikle, karşılaştırmayı Is gerçekleştirmek için veya IsNot işlecinin özelliğinin değerini okuması gerekir. Ancak özelliği şu anda depolarsa Nothing, özelliği formun yeni bir örneğini oluşturur ve bu örneği döndürür. Ancak, Visual Basic derleyicisi nesnenin My.Forms özelliklerini farklı işler ve veya IsNot işlecinin Is değerini değiştirmeden özelliğin durumunu denetlemesine izin verir.

Örnek

Bu örnek, varsayılan SidebarMenu formun başlığını değiştirir.

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

Bu örneğin çalışması için projenizin adlı SidebarMenubir formu olmalıdır.

Bu kod yalnızca bir Windows Uygulaması projesinde çalışır.

Gereksinimler

Proje Türüne Göre Kullanılabilirlik

Proje türü Kullanılabilir
Windows Uygulaması Evet
Sınıf Kitaplığı Hayır
Konsol Uygulaması Hayır
Windows Denetim Kitaplığı Hayır
Web Denetim Kitaplığı Hayır
Windows Hizmeti Hayır
Web Sitesi Hayır

Ayrıca bkz.