Metodo Control.CreateControlCollection (System.Web.UI)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Metodo Control.CreateControlCollection
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (letterali e server) del controllo server.

Spazio dei nomi:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)
Sintassi

Visual Basic
Protected Overridable Function CreateControlCollection As ControlCollection
C#
protected virtual ControlCollection CreateControlCollection()
Visual C++
protected:
virtual ControlCollection^ CreateControlCollection()
F#
abstract CreateControlCollection : unit -> ControlCollection 
override CreateControlCollection : unit -> ControlCollection 

Valore restituito

Tipo: System.Web.UI.ControlCollection
Oggetto ControlCollection che contiene i controlli server figlio del controllo server corrente.
Note

Eseguire l'override di questo metodo in un controllo server personalizzato se è stato creato un oggetto insieme derivato dalla classe ControlCollection. È quindi possibile creare l'istanza di tale classe di insiemi nell'override di questo metodo.

Esempi

Nell'esempio di codice riportato di seguito viene eseguito l'override del metodo CreateControlCollection per creare un'istanza della classe CustomControlCollection che eredita dalla classe ControlCollection.

Visual Basic

        ' 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



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


Nell'esempio di codice riportato di seguito viene utilizzato il metodo CreateControlCollection di un controllo server personalizzato per sottoporre a override il metodo CreateChildControls. Il nuovo insieme viene creato e poi compilato con due controlli figlio, firstControl e secondControl.

Visual Basic

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 'CreateChildControls




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



Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Vedere anche

Riferimenti