TemplateControl.LoadControl 方法

  • 参考

定义

命名空间:
System.Web.UI
程序集:
System.Web.dll

加载 Control。

重载

LoadControl(String)

根据指定的虚拟路径从文件加载 Control 对象。
LoadControl(Type, Object[])

根据指定类型和构造函数参数加载 Control 对象。

注解

将控件加载到容器控件中时，容器将引发添加的所有控件事件，直到它赶上当前事件。 但是，添加的 控件无法赶上回发数据处理。 对于要参与回发数据处理（包括验证）的添加控件，必须在 事件而不是 Init 事件中添加控件 Load 。

LoadControl(String)

根据指定的虚拟路径从文件加载 Control 对象。

public:
 System::Web::UI::Control ^ LoadControl(System::String ^ virtualPath);
public System.Web.UI.Control LoadControl (string virtualPath);
member this.LoadControl : string -> System.Web.UI.Control
Public Function LoadControl (virtualPath As String) As Control

参数

virtualPath
String

控件文件的虚拟路径。

返回

Control

返回指定的 Control。

例外

ArgumentNullException

虚拟路径为 null 或空。

示例

下面的代码示例演示如何使用 LoadControl 方法将用户控件添加到 ASP.NET 页。

在事件方法中 OnInit ，此页面使用 LoadControl 方法以编程方式在页面上创建用户控件。 方法将 控件添加到Controls名为 Placeholder1的 Web 服务器控件的 PlaceHolder 属性。

有关此代码示例中使用的 类的定义 MyControl ，请参阅 TemplateControl。

void Page_Init(object sender, System.EventArgs e)
{
    // Instantiate the UserControl object
    MyControl myControl1 =
        (MyControl)LoadControl("TempControl_Samples1.ascx.cs");
    PlaceHolder1.Controls.Add(myControl1);
}

Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    ' Obtain a UserControl object MyControl from the
    ' user control file TempControl_Samples1.ascx.vb
    Dim myControl1 As MyControl = CType(LoadControl("TempControl_Samples1.vb.ascx"), MyControl)
    Controls.Add(myControl1)
End Sub

注解

如果 控件支持缓存，则从 LoadControl 方法返回的对象实际上 Control 不是对象;而是对象 PartialCachingControl 。 virtualPath如果 参数是相对的，则加载控件的路径相对于 的路径TemplateControl。

将控件加载到容器控件中时，容器将引发添加的所有控件事件，直到它赶上当前事件。 但是，添加的 控件无法赶上回发数据处理。 对于要参与回发数据处理（包括验证）的添加控件，必须在 事件而不是 Init 事件中添加控件 Load 。

另请参阅

适用于

LoadControl(Type, Object[])

根据指定类型和构造函数参数加载 Control 对象。

public:
 System::Web::UI::Control ^ LoadControl(Type ^ t, cli::array <System::Object ^> ^ parameters);
public System.Web.UI.Control LoadControl (Type t, object[] parameters);
member this.LoadControl : Type * obj[] -> System.Web.UI.Control
Public Function LoadControl (t As Type, parameters As Object()) As Control

参数

t
Type

控件的类型。

parameters
Object[]

与要调用的构造函数的参数的编号、顺序和类型匹配的参数数组。 如果 parameters 为空数组或 null，则调用不带任何参数的构造函数（无参数构造函数）。

返回

Control

返回指定的 UserControl。

注解

如果用户控件支持缓存，则从 LoadControl 方法返回的对象实际上 UserControl 不是对象，而是对象 PartialCachingControl 。

将控件加载到容器控件中时，容器将引发添加的所有控件事件，直到它赶上当前事件。 但是，添加的 控件无法赶上回发数据处理。 对于要参与回发数据处理（包括验证）的添加控件，必须在 事件而不是 Init 事件中添加控件 Load 。

另请参阅

适用于