Control.CreateControlCollection Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literału i serwera) kontrolki serwera.

C#

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

Zwraca

ControlCollection

ControlCollection Obiekt zawierający kontrolki podrzędnego serwera kontroli bieżącego serwera.

Przykłady

Poniższy przykład kodu zastępuje metodę CreateControlCollection w celu utworzenia wystąpienia CustomControlCollection klasy, która dziedziczy z ControlCollection klasy.

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

Poniższy przykład kodu używa CreateControlCollection metody w niestandardowym przesłonięcie CreateChildControls kontroli serwera. Nowa kolekcja zostanie utworzona, a następnie wypełniona dwoma kontrolkami firstControl podrzędnymi i 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;
}

Uwagi

Zastąp tę metodę w niestandardowej kontrolce serwera, jeśli utworzono obiekt kolekcji, który pochodzi z ControlCollection klasy. Następnie można utworzyć wystąpienie tej klasy kolekcji w zastąpieniu tej metody.

Dotyczy

Zobacz też

• ControlCollection