Control.CreateControlCollection 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

建立新的 ControlCollection 物件來保存伺服器控制項的子控制項 (常值和伺服器)。

C#

protected virtual System.Web.UI.ControlCollection CreateControlCollection ();

傳回

ControlCollection

ControlCollection 物件，包含目前伺服器控制項的子伺服器控制項。

範例

下列程式碼範例會 CreateControlCollection 覆寫 方法，以建立繼承自 類別的 CustomControlCollection ControlCollection 類別實例。

C#

// Override the CreateControlCollection method to 
// write to the Trace object when tracing is enabled
// for the page or application in which this control
// is included.   
protected override ControlCollection CreateControlCollection()
{
    return new CustomControlCollection(this);
}

下列程式碼範例會在 CreateControlCollection 方法的 CreateChildControls 自訂伺服器控制項覆寫中使用 方法。 會建立新的集合，然後填入兩個子控制項和 firstControl secondControl 。

C#

protected override void CreateChildControls()
{               
   // Creates a new ControlCollection. 
   this.CreateControlCollection();

   // Create child controls.
    ChildControl firstControl = new ChildControl();
   firstControl.Message = "FirstChildControl";

   ChildControl secondControl = new ChildControl();
   secondControl.Message = "SecondChildControl";
   
   Controls.Add(firstControl);
   Controls.Add(secondControl);

   // Prevent child controls from being created again.
   ChildControlsCreated = true;
}

備註

如果您已建立衍生自 類別的 ControlCollection 集合物件，請在自訂伺服器控制項中覆寫這個方法。 然後，您可以在此方法的覆寫中具現化該集合類別。

適用於

另請參閱

• ControlCollection