Control.CreateControlCollection Yöntem

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur.

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

Döndürülenler

ControlCollection

ControlCollection Geçerli sunucu denetiminin alt sunucu denetimlerini içeren bir nesne.

Örnekler

Aşağıdaki kod örneği, sınıfından CreateControlCollection devralan ControlCollection bir CustomControlCollection sınıfın örneğini oluşturmak için yöntemini geçersiz kılar.

// 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

Aşağıdaki kod örneği, yönteminin CreateControlCollection özel bir sunucu denetimi geçersiz kılmasında CreateChildControls yöntemini kullanır. Yeni koleksiyon oluşturulur ve ardından ve iki alt denetimle firstControl secondControldoldurulur.

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

Açıklamalar

sınıfından türetilen bir koleksiyon nesnesi oluşturduysanız, özel bir sunucu denetiminde ControlCollection bu yöntemi geçersiz kılın. Daha sonra bu yöntemin geçersiz kılmasında bu koleksiyon sınıfının örneğini oluşturabilirsiniz.

Ayrıca bkz.

• ControlCollection