Control.Render(HtmlTextWriter) Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 public:
 virtual void Render(System::Web::UI::HtmlTextWriter ^ writer);

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

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

abstract member Render : System.Web.UI.HtmlTextWriter -> unit
override this.Render : System.Web.UI.HtmlTextWriter -> unit

Protected Overridable Sub Render (writer As HtmlTextWriter)

Protected Friend Overridable Sub Render (writer As HtmlTextWriter)

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

<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

Hinweise

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

Gilt für:

Freigeben über