共用方式為

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的 PlaceHolder Web 伺服器控制件屬性。

如您需要此程式碼範例中使用的類別定義 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 新增。

另請參閱

適用於