Control.Render(HtmlTextWriter) Methode
Definition
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 Serversteuerelementinhalte an ein bereitgestelltes HtmlTextWriter Objekt, das den inhalt schreibt, der auf dem Client gerendert werden soll.
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 -> unitProtected Overridable Sub Render (writer As HtmlTextWriter)Protected Friend Overridable Sub Render (writer As HtmlTextWriter)Parameter
- writer
- HtmlTextWriter
Das HtmlTextWriter Objekt, das den Serversteuerelementinhalt empfängt.
Beispiele
Das folgende Codebeispiel veranschaulicht das Überschreiben der Render Methode. Die HasControls Methode wird verwendet, um zu bestimmen, 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ü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 außer Kraft setzen, um Inhalte für eine ASP.NET Seite zu generieren.
