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 Methode verwendet, um sicherzustellen, dass das EnsureChildControls aktuelle Serversteuerelement untergeordnete Steuerelemente enthält. 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 lautet false, wird die CreateChildControls Methode aufgerufen.
Die EnsureChildControls Methode wird in der Regel in zusammengesetzten Steuerelementen verwendet, die untergeordnete Steuerelemente für einige oder alle ihre Funktionalität verwenden. Die EnsureChildControls Methode wird aufgerufen, um sicherzustellen, dass untergeordnete Steuerelemente erstellt wurden und bereit sind, Eingaben zu verarbeiten, datenbindung durchzuführen oder andere Aufgaben auszuführen.
Das GridView Steuerelement ist ein Beispiel für ein zusammengesetztes Steuerelement. Es erstellt untergeordnete Steuerelemente wie Table, TableRowLabelTableCellund TextBox Steuerelemente, die zum Rendern der HTML-Tabelle GridView verwendet werden, die generiert wird.
In den meisten Fällen müssen benutzerdefinierte Serversteuerungsentwickler diese Methode nicht außer Kraft setzen. Wenn Sie diese Methode außer Kraft setzen, verwenden Sie sie in einer Weise wie das Standardverhalten.