Control.EnsureChildControls Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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 -> unit

Protected 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.

Weitere Informationen

• Controls
• ChildControlsCreated
• CreateChildControls()