Control.CreateControlCollection Control.CreateControlCollection Control.CreateControlCollection Control.CreateControlCollection Method

Definizione

Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

protected:
 virtual System::Web::UI::ControlCollection ^ CreateControlCollection();
protected virtual System.Web.UI.ControlCollection CreateControlCollection ();
abstract member CreateControlCollection : unit -> System.Web.UI.ControlCollection
override this.CreateControlCollection : unit -> System.Web.UI.ControlCollection
Protected Overridable Function CreateControlCollection () As ControlCollection

Restituisce

Oggetto ControlCollection che contiene i controlli server figlio del controllo server corrente.A ControlCollection object to contain the current server control's child server controls.

Esempi

Nell'esempio di codice seguente viene CreateControlCollection eseguito l'override del metodo per creare CustomControlCollection un'istanza di una classe che ControlCollection eredita dalla classe.The following code example overrides the CreateControlCollection method to create an instance of a CustomControlCollection class, which inherits from the ControlCollection class.

// 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);
}
' 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 Overrides Function CreateControlCollection() As ControlCollection
    Return New CustomControlCollection(Me)
End Function

Nell'esempio CreateControlCollection CreateChildControls di codice seguente viene usato il metodo in un override del controllo server personalizzato del metodo.The following code example uses the CreateControlCollection method in a custom server control override of the CreateChildControls method. La nuova raccolta viene creata e popolata con due controlli figlio, firstControl e. secondControlThe new collection is created, and then populated with two child controls, firstControl and secondControl.


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;
}

Protected Overrides Sub CreateChildControls()
   ' Creates a new ControlCollection. 
   Me.CreateControlCollection()
   
   ' Create child controls.
   Dim firstControl As New ChildControl()
   firstControl.Message = "FirstChildControl"
   
   Dim secondControl As New ChildControl()
   secondControl.Message = "SecondChildControl"
   
   Controls.Add(firstControl)
   Controls.Add(secondControl)
   
   ' Prevent child controls from being created again.
   ChildControlsCreated = True
End Sub


Commenti

Eseguire l'override di questo metodo in un controllo server personalizzato se è stato creato un oggetto raccolta derivato dalla ControlCollection classe.Override this method in a custom server control if you have created a collection object that is derived from the ControlCollection class. È quindi possibile creare un'istanza della classe Collection nell'override di questo metodo.You can then instantiate that collection class in the override of this method.

Si applica a

Vedi anche