Control.EnsureChildControls Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt.
protected:
virtual void EnsureChildControls();protected virtual void EnsureChildControls();abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unitProtected Overridable Sub EnsureChildControls ()Voorbeelden
In het volgende voorbeeld wordt de EnsureChildControls methode gebruikt om ervoor te zorgen dat het huidige serverbesturingselement onderliggende besturingselementen bevat. Vervolgens wordt een Text eigenschap opgehaald of ingesteld voor een onderliggend TextBox webbesturingselement in het object van ControlCollection het huidige serverbesturingselement.
Important
Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.
// Ensure the current control has children,
// then get or set the Text property.
public int Value {
get {
this.EnsureChildControls();
return Int32.Parse(((TextBox)Controls[1]).Text);
}
set {
this.EnsureChildControls();
((TextBox)Controls[1]).Text = value.ToString();
}
}
' Ensure the current control has children,
' then get or set the Text property.
Public Property Value() As Integer
Get
Me.EnsureChildControls()
Return Int32.Parse(CType(Controls(1), TextBox).Text)
End Get
Set
Me.EnsureChildControls()
CType(Controls(1), TextBox).Text = value.ToString()
End Set
End Property
Opmerkingen
Met deze methode wordt eerst de huidige waarde van de ChildControlsCreated eigenschap gecontroleerd. Als deze waarde is false, wordt de CreateChildControls methode aangeroepen.
De EnsureChildControls methode wordt meestal gebruikt in samengestelde besturingselementen. Dit zijn besturingselementen die onderliggende besturingselementen gebruiken voor bepaalde of alle functionaliteit ervan. De EnsureChildControls methode wordt aangeroepen om ervoor te zorgen dat onderliggende besturingselementen zijn gemaakt en gereed zijn voor het verwerken van invoer, het uitvoeren van gegevensbinding of het uitvoeren van andere taken.
Het GridView besturingselement is een voorbeeld van een samengesteld besturingselement. Er worden onderliggende besturingselementen gemaakt, zoals Table, TableRow, TableCellen LabelTextBoxbesturingselementen, die worden gebruikt om de HTML-tabel weer te geven die door de GridView gegenereerde tabel worden gegenereerd.
In de meeste gevallen hoeven ontwikkelaars van aangepaste serverbeheer deze methode niet te overschrijven. Als u deze methode overschrijft, gebruikt u deze op een manier die vergelijkbaar is met het standaardgedrag.
