Control.EnsureChildControls メソッド

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

Control.EnsureChildControls メソッド

サーバー コントロールに子コントロールが含まれているかどうかを確認します。含まれていない場合、子コントロールを作成します。

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

Visual Basic (宣言)

Protected Overridable Sub
 EnsureChildControls

Visual Basic (使用法)

Me.EnsureChildControls

C#

protected virtual void EnsureChildControls
 ()

C++

protected:
virtual void EnsureChildControls ()

J#

protected void EnsureChildControls ()

JScript

protected function EnsureChildControls ()

解説

このメソッドは最初に ChildControlsCreated プロパティの現在の値をチェックします。この値が false の場合、CreateChildControls メソッドが呼び出されます。

ASP.NET は、子コントロールが作成済みであることを確認する必要があるときにはこのメソッドを呼び出します。ほとんどの場合、カスタム サーバー コントロールの開発者はこのメソッドをオーバーライドする必要はありません。このメソッドをオーバーライドするときには、既定の動作に類似する方法で使用します。

使用例

EnsureChildControls メソッドを使用して、現在のサーバー コントロールが子コントロールを持つように設定する例を次に示します。その後、現在のサーバー コントロールの ControlCollection オブジェクトにある子の TextBox Web コントロールの Text プロパティを取得または設定します。

Visual Basic

' Ensure the current control has children,
' then get or set the Text property.

Public Property Value() As
 Integer
   Get
      Me.EnsureChildControls()
      Return Int32.Parse(CType(Controls(1), TextBox).Text)
   End Get
   Set
      Me.EnsureChildControls()
      CType(Controls(1), TextBox).Text = value.ToString()
   End Set
End Property

C#

// Ensure the current control has children,
// then get or set the Text property.
 public int Value {
    get {
        this.EnsureChildControls();
        return Int32.Parse(((TextBox)Controls[1]).Text);
    }
    set {
        this.EnsureChildControls();
        ((TextBox)Controls[1]).Text = value.ToString();
    }
 }

J#

// Ensure the current control has children,
// then get or set the Text property.
/** @property 
 */
public int get_Value()
{
    this.EnsureChildControls();
    return Int32.Parse(((TextBox)(get_Controls().get_Item(1))).get_Text());
} //get_Value

/** @property 
 */
public void set_Value(int
 value)
{
    this.EnsureChildControls();
    ((TextBox)get_Controls().get_Item(1)).set_Text(((Int32)value).ToString());
} //set_Value

JScript

// Ensure the current control has children,
// then get or set the Text property.
 public function get Value()
 : int
 {
       this.EnsureChildControls();
       return Int32.Parse(TextBox(Controls[1]).Text);
 }

 public function set Value(value
 : int)
 {
        this.EnsureChildControls();
        TextBox(Controls[1]).Text = value.ToString();
 }

プラットフォーム

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 名前空間
Controls
ChildControlsCreated
CreateChildControls