Auf Englisch lesen

Freigeben über


Control.Render(HtmlTextWriter) Methode

Definition

Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt.

protected virtual void Render(System.Web.UI.HtmlTextWriter writer);
protected internal virtual void Render(System.Web.UI.HtmlTextWriter writer);

Parameter

writer
HtmlTextWriter

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

Beispiele

Im folgenden Codebeispiel wird das Überschreiben der Render -Methode veranschaulicht. Die HasControls -Methode wird verwendet, um zu bestimmen, ob das Serversteuerelement über untergeordnete Steuerelemente in seinem ControlCollection Objekt gespeichert ist, auf das über die Control.Controls -Eigenschaft zugegriffen werden kann. Wenn HasControls true zurückgegeben wird und das erste Serversteuerelement in der Auflistung Literaltext ist, wird der Literaltext an eine HTML-Zeichenfolge angefügt.

[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>");
    }
}

Hinweise

Beim Entwickeln benutzerdefinierter Serversteuerelemente können Sie diese Methode überschreiben, um Inhalte für eine ASP.NET Seite zu generieren.

Gilt für:

Produkt Versionen
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Weitere Informationen