Freigeben über


Control.Render-Methode

Sendet den Inhalt eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt, das den Inhalt für die Wiedergabe auf den Client schreibt.

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

Syntax

'Declaration
Protected Friend Overridable Sub Render ( _
    writer As HtmlTextWriter _
)
'Usage
Dim writer As HtmlTextWriter

Me.Render(writer)
protected internal virtual void Render (
    HtmlTextWriter writer
)
protected public:
virtual void Render (
    HtmlTextWriter^ writer
)
protected void Render (
    HtmlTextWriter writer
)
protected internal function Render (
    writer : HtmlTextWriter
)

Parameter

  • writer
    Das HtmlTextWriter-Objekt, das den Inhalt des Serversteuerelements empfängt.

Hinweise

Beim Entwickeln von benutzerdefinierten Serversteuerelementen können Sie diese Methode zum Generieren von Inhalt für eine ASP.NET-Seite überschreiben.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der Render-Methode veranschaulicht. Mit der HasControls-Methode wird bestimmt, ob das Serversteuerelement über untergeordnete Steuerelemente verfügt, die in seinem ControlCollection-Objekt gespeichert sind, auf das über die Control.Controls-Eigenschaft zugegriffen werden kann. Wenn HasControls True zurückgibt und es sich bei dem ersten Serversteuerelement in der Auflistung um Literaltext handelt, wird der Literaltext an eine HTML-Zeichenfolge angehängt.

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(Output As HtmlTextWriter)
    If HasControls() And TypeOf Controls(0) Is LiteralControl
        Dim Ctrl As LiteralControl = CType(Controls(0), LiteralControl)
        Output.Write("<H2>Your Message: " & Ctrl.Text & "</H2>")
    End If
End Sub
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
protected override void Render(HtmlTextWriter output) {
    if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
        output.Write("<H2>Your Message: " + ((LiteralControl) Controls[0]).Text + "</H2>");
    }
}
protected override function Render(output : HtmlTextWriter) {
var securityperm : SecurityPermission;
         securityperm = new SecurityPermission(SecurityPermissionFlag.SerializationFormatter);
         securityperm.Demand();
    if ( (HasControls()) && (typeof(Controls[0]) == LiteralControl) ) {
        output.Write("<H2>Your Message: " + (LiteralControl(Controls[0])).Text + "</H2>");
    }
}

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
HtmlTextWriter

Weitere Ressourcen

Übersicht über den Lebenszyklus von ASP.NET-Seiten