ControlBuilder.AppendSubBuilder-Methode

Artikel
08/20/2007

Fügt dem ControlBuilder-Objekt Generatoren für alle untergeordneten Steuerelemente hinzu, die zu dem Containersteuerelement gehören.

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

Syntax

'Declaration
Public Overridable Sub AppendSubBuilder ( _
    subBuilder As ControlBuilder _
)
'Usage
Dim instance As ControlBuilder
Dim subBuilder As ControlBuilder

instance.AppendSubBuilder(subBuilder)

public virtual void AppendSubBuilder (
    ControlBuilder subBuilder
)

public:
virtual void AppendSubBuilder (
    ControlBuilder^ subBuilder
)

public void AppendSubBuilder (
    ControlBuilder subBuilder
)

public function AppendSubBuilder (
    subBuilder : ControlBuilder
)

Parameter

subBuilder
Der dem untergeordneten Steuerelement zugewiesene ControlBuilder.

Beispiel

Im folgenden Beispiel wird die AppendSubBuilder-Methode überschrieben, sodass sie eine Exception auslöst, wenn das Steuerelement, auf das dieser Steuerelement-Generator angewendet wird, versucht, Steuerelemente in seine Instanz der ControlCollection-Klasse einzubeziehen.

' Override the AppendSubBuilder method to throw an
' exception if the class it is applied to attempts
' to include child controls. 
Public Overrides Sub AppendSubBuilder(ByVal subBuilder As ControlBuilder)
    Throw New Exception( _
       "A custom label control cannot contain other objects.")
End Sub

// Override the AppendSubBuilder method to throw an
// exception if the class it is applied to attempts
// to include child controls. 
public override void AppendSubBuilder(ControlBuilder subBuilder)
{
    throw new Exception(
        "A custom label control cannot contain other objects.");
}

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

ControlBuilder-Klasse
ControlBuilder-Member
System.Web.UI-Namespace
ControlBuilder-Klasse

Freigeben über