ControlCollection.Add(Control) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した Control オブジェクトをコレクションに追加します。
public:
virtual void Add(System::Web::UI::Control ^ child);public virtual void Add (System.Web.UI.Control child);abstract member Add : System.Web.UI.Control -> unit
override this.Add : System.Web.UI.Control -> unitPublic Overridable Sub Add (child As Control)パラメーター
例外
child パラメーターがコントロールを指定しません。
ControlCollection は読み取り専用です。
例
次のコード例では、メソッドを Add 使用して、一連のテンプレート項目 (サーバー コントロールのビューステートから取得される数) をカスタム テンプレート コントロールに追加します。
// 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 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
注釈
新しいコントロールが序数インデックス配列の末尾に追加されます。 コントロールには、任意の ASP.NET サーバー コントロールのインスタンス、作成するカスタム サーバー コントロール、またはリテラル コントロールを指定できます。
特定のインデックス位置にあるコレクションにコントロールを追加するには、メソッドを AddAt 使用します。