Control.ControlCollection.Clear メソッド

コレクションからすべてのコントロールを削除します。

Public Overridable Sub Clear() Implements IList.Clear
[C#]
public virtual void Clear();
[C++]
public: virtual void Clear();
[JScript]
public function Clear();

実装

IList.Clear

解説

Clear メソッドを使用して、親コントロールからコントロールのコレクション全体を削除できます。

コレクションからコントロールを個別に削除するには、 Remove メソッドまたは RemoveAt メソッドを使用します。

新しい Control オブジェクトをコレクションに追加するには、 Add メソッドまたは AddRange メソッドを使用します。

継承時の注意: 派生クラスで Clear をオーバーライドする場合は、基本クラスの Clear メソッドを呼び出して、確実にすべてのコントロールがコレクションから削除されるようにしてください。

使用例

[Visual Basic, C#, C++] 派生クラス Panel の Control.ControlCollection にあるすべての Control オブジェクトを削除する例を次に示します。この例は、 Form 上に Panel 、 Button 、およびその他のコントロールが少なくとも 1 つ作成されていることを前提にしています。その他のコントロールは Panel コントロールに追加され、 Panel は Form に追加されます。ボタンがクリックされると、パネルに含まれているすべてのコントロールが Control.ControlCollection から削除されます。

 
' Clear all the controls in the Panel.
Private Sub ClearButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles ClearButton.Click
    Panel1.Controls.Clear()
End Sub

[C#] 
// Clear all the controls in the Panel.
private void clearButton_Click(object sender, System.EventArgs e)
{
   panel1.Controls.Clear();
}

[C++] 
// Clear all the controls in the Panel.
private:
void clearButton_Click(Object* /*sender*/, System::EventArgs* /*e*/) {
    panel1->Controls->Clear();
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

Control.ControlCollection クラス | Control.ControlCollection メンバ | System.Windows.Forms 名前空間