My.Forms 对象

更新：2007 年 11 月

提供属性，用于访问在当前项目中声明的每个 Windows 窗体的实例。

备注

My.Forms 对象提供了当前项目中每个窗体的实例。属性与它所访问的窗体同名。有关向项目添加窗体的信息，请参见 如何：向项目添加 Windows 窗体。

您可以通过使用窗体名称（无需限定）访问由 My.Forms 对象提供的窗体。由于属性名称与窗体的类型名称相同，这将允许您如同窗体具有默认实例那样来访问窗体。例如，My.Forms.Form1.Show 等效于 Form1.Show。

My.Forms 对象仅公开与当前项目关联的窗体。它不会提供对在引用 DLL 中声明的窗体的访问。若要访问 DLL 提供的窗体，必须使用窗体的限定名，书写格式为 Dll 名称.窗体名称。有关更多信息，请参见 如何：访问窗体。

可以使用 My.Application.OpenForms 属性 获取所有应用程序的打开窗体的集合。

此对象及其属性仅可用于 Windows 应用程序。

属性

My.Forms 对象的每个属性提供了对当前项目中某个窗体实例的访问。属性与此属性所访问的窗体同名，且属性类型与窗体类型相同。

说明：
如果发生名称冲突，则用于访问窗体的属性名称将为根命名空间_命名空间_窗体名称。例如，假设有两个名为 Form1. 的窗体。如果其中一个窗体在根命名空间 WindowsApplication1 和命名空间 Namespace1 中，则您可以通过 My.Forms.WindowsApplication1_Namespace1_Form1 访问该窗体。

My.Forms 对象提供了对在启动时创建的应用程序主窗体实例的访问。对于所有其他窗体，My.Forms 对象创建一个新的窗体实例（在它被访问时），并存储该实例。访问该属性的后续尝试将返回此窗体实例。

您可以通过将 Nothing 赋予该窗体的属性来释放窗体。属性 setter 调用窗体的 Close 方法，然后将 Nothing 赋予存储的值。如果向属性赋予 Nothing 以外的任何值，setter 将引发 ArgumentException 异常。

您可以通过使用 Is 或 IsNot 运算符来测试 My.Forms 对象的属性是否存储了窗体的实例，并可以使用这些运算符来检查此属性的值是否为 Nothing。

说明：
通常，Is 或 IsNot 运算符必须读取此属性的值以执行比较。但是，如果属性当前存储的值为 Nothing，该属性将创建窗体的一个新实例，然后返回该实例。不过，Visual Basic 编译器将特殊对待 My.Forms 对象的属性，并且允许 Is 或 IsNot 运算符检查属性的状态而不改变其值。

任务

下表列出了涉及 My.Forms 对象的任务的示例。

示例

此示例更改默认 SidebarMenu 窗体的标题。

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

若要使此示例正常工作，项目必须具有名为 SidebarMenu 的窗体。有关更多信息，请参见如何：向项目添加 Windows 窗体。

这些代码将只能在 Windows 应用程序项目中正常运行。

要求

各项目类型的可用性

请参见

任务

如何：向项目添加 Windows 窗体

如何：访问窗体

概念

访问应用程序窗体

参考

My.Application.OpenForms 属性

My.Application.OpenForms 属性

Is 运算符 (Visual Basic)

IsNot 运算符

Form

Close