次の方法で共有


TemplateControl.LoadControl メソッド

定義

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 使用して、プログラムによってページ上にユーザー コントロールを作成します。 メソッドは、 という名前Placeholder1の Web サーバー コントロールControlsの プロパティに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 。 パラメーターが relative の 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 必要があります。

こちらもご覧ください

適用対象