ControlCollection.Add メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ControlCollection.Add メソッド

指定した Control オブジェクトをコレクションに追加します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub Add
 ( _
    child As Control _
)

Visual Basic (使用法)

Dim instance As ControlCollection
Dim child As Control

instance.Add(child)

public virtual void Add (
    Control child
)

C++

public:
virtual void Add (
    Control^ child
)

public void Add (
    Control child
)

JScript

public function Add (
    child : Control
)

パラメータ

child: コレクションに追加する Control。

例外

例外の種類	条件
ArgumentNullException	child パラメータがコントロールを指定しない場合にスローされます。
HttpException	ControlCollection が読み取り専用の場合にスローされます。

解説

使用例

Add メソッドを使用して、一連のテンプレート項目 (サーバーコントロールのビューステートから取得される数) を template 宣言されたカスタムコントロールに追加するコード例を次に示します。

Visual Basic

' Override to create repeated items.
Protected Overrides Sub
 CreateChildControls()
    Dim O As Object = ViewState("NumItems")
    If Not (O Is Nothing)
       ' Clear any existing child controls.
       Controls.Clear()

       Dim I As Integer
       Dim NumItems As Integer
 = CInt(O)
       For I = 0 To NumItems - 1
          ' Create an item.
          Dim Item As RepeaterItemVB = New
 RepeaterItemVB(I, Nothing)
          ' Initialize the item from the template.
          ItemTemplate.InstantiateIn(Item)
          ' Add the item to the ControlCollection.
          Controls.Add(Item)
       Next
    End If
End Sub

// Override to create repeated items.
protected override void CreateChildControls()
 {
    object o = ViewState["NumItems"];
    if (o != null) {
       // Clear any existing child controls.
       Controls.Clear();

       int numItems = (int)o;
       for (int i=0; i < numItems; i++)
 {
          // Create an item.
          RepeaterItem item = new RepeaterItem(i, null);
          // Initialize the item from the template.
          ItemTemplate.InstantiateIn(item);
          // Add the item to the ControlCollection.
          Controls.Add(item);
       }
    }
}

// Override to create repeated items.
protected void CreateChildControls()
{
    Object o = get_ViewState().get_Item("NumItems");
    if (o != null) {
        // Clear any existing child controls.
        get_Controls().Clear();

        int numItems = Convert.ToInt32(o);
        for (int i = 0; i < numItems; i++)
 {
            // Create an item.
            RepeaterItem item = new RepeaterItem(i, null);
            // Initialize the item from the template.
            get_ItemTemplate().InstantiateIn(item);
            // Add the item to the ControlCollection.
            get_Controls().Add(item);
        }
    }
} //CreateChildControls