TemplateControl.LoadControl 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
載入 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。
例外狀況
虛擬路徑為 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
,則會叫用未採用參數的建構函式 (無參數建構函式)。
傳回
傳回指定的 UserControl。
備註
如果使用者控制項支援快取,則從 LoadControl 方法傳回的物件實際上 UserControl 不是 物件, PartialCachingControl 而是 物件。
當您將控制項載入至容器控制項時,容器會引發所有新增控制項的事件,直到它趕上目前的事件為止。 不過,新增的 控制項不會趕上回傳資料處理。 若要讓新增的控制項參與回傳資料處理,包括驗證,控制項必須在事件中 Init 新增,而不是在 事件中 Load 加入。
另請參閱
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應