Control.EnsureChildControls-Methode

Artikel
08/20/2007

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overridable Sub EnsureChildControls
'Usage

Me.EnsureChildControls

protected virtual void EnsureChildControls ()

protected:
virtual void EnsureChildControls ()

protected void EnsureChildControls ()

protected function EnsureChildControls ()

Hinweise

Diese Methode überprüft zuerst den aktuellen Wert der ChildControlsCreated-Eigenschaft. Wenn dieser Wert False ist, wird die CreateChildControls-Methode aufgerufen.

ASP.NET ruft diese Methode auf, wenn sichergestellt werden muss, dass untergeordnete Steuerelemente erstellt wurden. In den meisten Fällen müssen Entwickler von benutzerdefinierten Steuerelementen diese Methode nicht überschreiben. Wenn Sie diese Methode überschreiben, verwenden Sie sie auf ähnliche Weise wie ihr Standardverhalten.

Beispiel

Im folgenden Beispiel wird mithilfe der EnsureChildControls-Methode sichergestellt, dass das aktuelle Serversteuerelement über untergeordnete Steuerelemente verfügt. Anschließend wird eine Text-Eigenschaft für ein untergeordnetes TextBox-Websteuerelement im ControlCollection-Objekt des aktuellen Serversteuerelements abgerufen oder festgelegt.

' 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

// 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.
/** @property 
 */
public int get_Value()
{
    this.EnsureChildControls();
    return Int32.Parse(((TextBox)(get_Controls().get_Item(1))).get_Text());
} //get_Value

/** @property 
 */
public void set_Value(int value)
{
    this.EnsureChildControls();
    ((TextBox)get_Controls().get_Item(1)).set_Text(((Int32)value).ToString());
} //set_Value

// Ensure the current control has children,
// then get or set the Text property.
 public function get Value() : int
 {
       this.EnsureChildControls();
       return Int32.Parse(TextBox(Controls[1]).Text);
 }

 public function set Value(value : int)
 {
        this.EnsureChildControls();
        TextBox(Controls[1]).Text = value.ToString();
 }

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Web.UI-Namespace
Controls
ChildControlsCreated
CreateChildControls

Freigeben über