ControlCollection.Remove メソッド

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

ControlCollection.Remove メソッド

親サーバー コントロールの ControlCollection オブジェクトから、指定したサーバー コントロールを削除します。

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

Visual Basic (宣言)

Public Overridable Sub Remove
 ( _
    value As Control _
)

Visual Basic (使用法)

Dim instance As ControlCollection
Dim value As Control

instance.Remove(value)

C#

public virtual void Remove (
    Control value
)

C++

public:
virtual void Remove (
    Control^ value
)

J#

public void Remove (
    Control value
)

JScript

public function Remove (
    value : Control
)

パラメータ

value

削除されるサーバー コントロール。

解説

インデックス位置からコントロールを削除するには、RemoveAt メソッドを使用します。

使用例

Remove メソッドを使用して、myButton サーバー コントロールから子コントロールを削除するコード例を次に示します。このコードは、まず Contains メソッドを使用して ControlCollection オブジェクトに myChildControl が含まれているかどうかを確認し、含まれていればそれを削除します。

Visual Basic

' Use the Contains method to check whether
' a child control exists, and if it does,
' use the Remove method to delete it.        
If myButton.Controls.Contains(myChildControl)
   myButton.Controls.Remove(myChildControl)
   msgRemove.Text = "You removed myLiteralControl."
Else
   msgRemove.Text="The control to remove does not exist."
 
End If

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ControlCollection クラス
ControlCollection メンバ
System.Web.UI 名前空間
RemoveAt
Control.Controls プロパティ