Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che utilizzano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti per la preparazione al postback o al rendering.
Assembly: System.Web (in System.Web.dll)
Protected Friend Overridable Sub CreateChildControls
protected internal virtual void CreateChildControls()
protected public: virtual void CreateChildControls()
abstract CreateChildControls : unit -> unit override CreateChildControls : unit -> unit
Quando si sviluppa un controllo server composito o basato su template, eseguire l'override di questo metodo. I controlli che eseguono l'override del metodo CreateChildControls devono implementare l'interfaccia INamingContainer per evitare conflitti di denominazione.
Per ulteriori informazioni, vedere Modelli dei controlli server Web ASP.NET e Sviluppo di controlli server ASP.NET personalizzati.
Nell'esempio seguente viene descritta una versione sottoposta a override del metodo CreateChildControls. In questa implementazione il controllo composito visualizza un controllo TextBox delimitato da due controlli che effettuano il rendering di HTML.
Nota sulla sicurezza
|
|---|
|
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script. |
' Override CreateChildControls to create the control tree. <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _ Protected Overrides Sub CreateChildControls() ' Add a LiteralControl to the current ControlCollection. Me.Controls.Add(New LiteralControl("<h3>Value: ")) ' Create a text box control, set the default Text property, ' and add it to the ControlCollection. Dim box As New TextBox() box.Text = "0" Me.Controls.Add(box) Me.Controls.Add(New LiteralControl("</h3>")) End Sub 'CreateChildControls
// Override CreateChildControls to create the control tree.
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")]
protected override void CreateChildControls() {
// Add a LiteralControl to the current ControlCollection.
this.Controls.Add(new LiteralControl("<h3>Value: "));
// Create a text box control, set the default Text property,
// and add it to the ControlCollection.
TextBox box = new TextBox();
box.Text = "0";
this.Controls.Add(box);
this.Controls.Add(new LiteralControl("</h3>"));
}
.NET Framework
Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0Windows 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.