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

こちらもご覧ください

適用対象