TemplateControl.LoadControl 方法

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

參數

傳回

傳回指定的 Control。

例外狀況

範例

下列程式碼範例示範如何使用 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 加入。

另請參閱

• UserControl
• LoadControl(Type, Object[])
• OnInit(EventArgs)
• OnLoad(EventArgs)
• ASP.NET 網頁生命週期概觀

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

參數

傳回

傳回指定的 UserControl。

備註

如果使用者控制項支援快取，則從 LoadControl 方法傳回的物件實際上 UserControl 不是 物件， PartialCachingControl 而是 物件。

當您將控制項載入至容器控制項時，容器會引發所有新增控制項的事件，直到它趕上目前的事件為止。 不過，新增的 控制項不會趕上回傳資料處理。 若要讓新增的控制項參與回傳資料處理，包括驗證，控制項必須在事件中 Init 新增，而不是在 事件中 Load 加入。

另請參閱

• UserControl
• LoadControl(String)
• OnInit(EventArgs)
• OnLoad(EventArgs)
• ASP.NET 網頁生命週期概觀