Control.EnsureChildControls 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

判斷伺服器控制項是否包含子控制項。 如果不包含，則建立子控制項。

protected:
 virtual void EnsureChildControls();

protected virtual void EnsureChildControls ();

abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unit

Protected Overridable Sub EnsureChildControls ()

範例

下列範例會 EnsureChildControls 使用 方法來確保目前的伺服器控制項具有子控件。 然後，它會取得或設定 Text 目前伺服器控制件物件中子 TextBox Web 控件的屬性 ControlCollection 。

重要

這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。 根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊，請參閱 Script Exploits Overview (指令碼攻擊概觀)。

// 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();
    }
 }

' 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

備註

這個方法會先檢查 屬性的 ChildControlsCreated 目前值。 如果此值為 false，則會 CreateChildControls 呼叫 方法。

方法 EnsureChildControls 通常用於複合控件，這些控件是針對某些或所有功能使用子控件的控件。 系統會 EnsureChildControls 呼叫 方法，以確保已建立子控件，並準備好處理輸入、執行數據系結，或執行其他工作。

控件 GridView 是複合控件的範例。 它會建立子控件，例如 Table、 TableRow、 TableCell、 Label和 TextBox 控件，用來呈現產生的 HTML 數據表 GridView 。

在大部分情況下，自定義伺服器控件開發人員不需要覆寫此方法。 如果您覆寫這個方法，請以類似預設行為的方式使用它。

另請參閱

• Controls
• ChildControlsCreated
• CreateChildControls()