Control.Controlsとは何？わかりやすく解説 Weblio辞書

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

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

Control.Controls プロパティ

UI 階層構造の指定されたサーバーコントロールの子コントロールを表す ControlCollection オブジェクトを取得します。

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

Visual Basic (宣言)

Public Overridable ReadOnly
 Property Controls As ControlCollection

Visual Basic (使用法)

Dim instance As Control
Dim value As ControlCollection

value = instance.Controls

public virtual ControlCollection Controls { get;
 }

C++

public:
virtual property ControlCollection^ Controls {
    ControlCollection^ get ();
}

/** @property */
public ControlCollection get_Controls ()

JScript

public function get Controls
 () : ControlCollection

プロパティ値
指定されたサーバーコントロールの子コントロールのコレクション。

解説

ASP.NET ページでは、サーバーコントロールの開始タグと終了タグの間でコントロールを宣言して追加すると、ASP.NET は自動的にそのコントロールを、格納する側のサーバーコントロールの ControlCollection に追加します。サーバーで処理されない HTML タグまたは文字列は LiteralControl オブジェクトとして扱われます。これらは、他のサーバーコントロールと同様にコレクションに追加されます。

Controls プロパティは、任意のサーバーコントロールの ControlCollection クラスにプログラムによりアクセスできるようにします。コントロールをコレクションに追加したり、コレクションから削除できます。また、コレクションのサーバーコントロールを反復処理できます。

継承時の注意 Controls プロパティをオーバーライドするときは、必ず EnsureChildControls メソッドを呼び出してください。さらに、プログラムによってコントロールコレクションにコントロールを追加することを計画している場合は、オーバーライドされた CreateChildControls メソッドでコントロールを追加することを検討してください。

Topic	Location
方法 : Calendar Web サーバーコントロールにおける日単位のカスタマイズ	ASP .NET Web アプリケーションの作成
方法 : template 宣言された ASP.NET ユーザーコントロールを作成する	ASP .NET Web アプリケーションの作成
方法 : Web フォームページに PlaceHolder Web サーバーコントロールを追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

Controls プロパティを通じてサーバーコントロールの ControlCollection オブジェクトに子コントロールを追加する方法を次の例に示します。

Visual Basic

Controls.Add(New LiteralControl("<h3>Value:
 "))

Controls.Add(new LiteralControl("<h3>Value: "));

get_Controls().Add(new LiteralControl("<h3>Value: "));

JScript

Controls.Add(new LiteralControl("<h3>Value: "));

pt]
this.Controls.Add(new LiteralControl("<h3>Value:
 "));

プラットフォーム

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

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
ControlCollection
CreateControlCollection
CreateChildControls

Control.Controls プロパティ

コントロール内に格納されているコントロールのコレクションを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Controls As ControlCollection

Visual Basic (使用法)

Dim instance As Control
Dim value As ControlCollection

value = instance.Controls

public ControlCollection Controls { get; }

C++

public:
property ControlCollection^ Controls {
    ControlCollection^ get ();
}

/** @property */
public ControlCollection get_Controls ()

JScript

public function get Controls
 () : ControlCollection

プロパティ値
コントロール内に格納されているコントロールのコレクションを表す Control.ControlCollection。

解説

Control は、コントロールのコレクションの親としての機能を果たします。たとえば、複数のコントロールが Form に追加されると、各コントロールは、Control クラスから派生した、フォームの Controls プロパティに割り当てられた Control.ControlCollection のメンバになります。

Control.ControlCollection クラスで使用できるメソッドを使用して、Controls プロパティに割り当てられた Control.ControlCollection 内のコントロールを操作できます。

複数のコントロールを親コントロールに追加する場合は、追加するコントロールを初期化する前に SuspendLayout メソッドを呼び出すことをお勧めします。コントロールを親コントロールに追加した後は、ResumeLayout メソッドを呼び出します。そうすることで、多数のコントロールを持つアプリケーションのパフォーマンスが向上します。

使用例

Control が派生クラス Panel の Control.ControlCollection のメンバである場合に、そのコントロールをコレクションから削除するコード例を次に示します。この例では、Form 上に Panel、Button、および少なくとも 1 つの RadioButton コントロールが作成されている必要があります。RadioButton コントロールは Panel コントロールに追加され、Panel コントロールが Form コントロールに追加されます。ボタンがクリックされると、radioButton2 という名前のオプションボタンが Control.ControlCollection から削除されます。

Visual Basic

' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal
 sender As System.Object, _
    ByVal e As System.EventArgs) Handles
 RemoveButton.Click
    If Panel1.Controls.Contains(RadioAddRangeButton) Then
        Panel1.Controls.Remove(RadioAddRangeButton)
    End If
End Sub

// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender,
 System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

C++

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }

// Remove the RadioButton control if it exists.
private void removeButton_Click(Object sender,
 System.EventArgs e)
{
    if (panel1.get_Controls().Contains(removeButton)) {
        panel1.get_Controls().Remove(removeButton);
    }
} //removeButton_Click