Control.ControlCollection.RemoveAt(Int32) Control.ControlCollection.RemoveAt(Int32) Control.ControlCollection.RemoveAt(Int32) Control.ControlCollection.RemoveAt(Int32) Method


指定したインデックス位置にあるコントロール コレクションからコントロールを削除します。Removes a control from the control collection at the specified indexed location.

 virtual void RemoveAt(int index);
public void RemoveAt (int index);
abstract member RemoveAt : int -> unit
override this.RemoveAt : int -> unit
Public Sub RemoveAt (index As Integer)


Int32 Int32 Int32 Int32

削除する Control のインデックス値。The index value of the Control to remove.


次のコード例では、コレクションの数が0より大きい場合に、派生クラス Panel の @no__t の最初の @no__t 0 を削除します。The following code example removes the first Control in the Control.ControlCollection of the derived class Panel if the count of the collection is greater than zero. この例では、@no__t 0、Button、および Form の他の1つ以上のコントロールを作成しておく必要があります。The example requires that you have created a Panel, a Button, and at least one other control on a Form. その他のコントロールは @no__t 0 コントロールに追加され、@no__t 1 コントロールは Form に追加されます。The other controls are added to the Panel control, and the Panel control added to the Form. ボタンがクリックされると、パネルに含まれている最初のコントロールが @no__t 0 から削除されます。When the button is clicked, the first control contained in the panel is removed from the Control.ControlCollection.

   // Remove the first control in the collection.
   void removeAtButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
      if ( panel1->Controls->Count > 0 )
         panel1->Controls->RemoveAt( 0 );
// Remove the first control in the collection.
private void removeAtButton_Click(object sender, System.EventArgs e)
   if (panel1.Controls.Count > 0)
' Remove the first control in the collection.
Private Sub RemoveAtButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveAtButton.Click
    If (Panel1.Controls.Count > 0) Then
    End If
End Sub


@No__t-0 がコントロールコレクションから削除されると、後続のすべてのコントロールがコレクション内の1つ上の位置に移動します。When a Control is removed from the control collection, all subsequent controls are moved up one position in the collection.

@No__t-1 または Clear のメソッドを使用して、以前に追加した @no__t 0 を削除することもできます。You can also remove a Control that you previously added by using the Remove or Clear methods.

新しい Control オブジェクトをコレクションに追加するには、Add または AddRange メソッドを使用します。To add new Control objects to the collection, use the Add or AddRange methods.