Control.EnsureChildControls Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.
protected:
virtual void EnsureChildControls();protected virtual void EnsureChildControls ();abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unitProtected Overridable Sub EnsureChildControls ()Beispiele
Im folgenden Beispiel wird die EnsureChildControls -Methode verwendet, um sicherzustellen, dass das aktuelle Serversteuerelement über untergeordnete Steuerelemente verfügt. Anschließend wird eine Eigenschaft für ein Text untergeordnetes TextBox Websteuerelement im Objekt des aktuellen Serversteuerelements ControlCollection abgerufen oder festgelegt.
Wichtig
Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.
// 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
Hinweise
Diese Methode überprüft zunächst den aktuellen Wert der ChildControlsCreated Eigenschaft. Wenn dieser Wert ist false, wird die CreateChildControls -Methode aufgerufen.
Die EnsureChildControls -Methode wird in der Regel in zusammengesetzten Steuerelementen verwendet, bei denen es sich um Steuerelemente handelt, die untergeordnete Steuerelemente für einen Teil oder für ihre gesamte Funktionalität verwenden. Die EnsureChildControls -Methode wird aufgerufen, um sicherzustellen, dass untergeordnete Steuerelemente erstellt wurden und bereit sind, Eingaben zu verarbeiten, Datenbindungen auszuführen oder andere Aufgaben auszuführen.
Das GridView Steuerelement ist ein Beispiel für ein zusammengesetztes Steuerelement. Es werden untergeordnete Steuerelemente wie Table, TableRow, TableCell, Labelund TextBox erstellt, die zum Rendern der von generierten GridView HTML-Tabelle verwendet werden.
In den meisten Fällen müssen Entwickler von benutzerdefinierten Serversteuerelementen diese Methode nicht außer Kraft setzen. Wenn Sie diese Methode überschreiben, verwenden Sie sie ähnlich dem Standardverhalten.
