Label.RenderContents-Methode

Artikel
08/20/2007

Diese Methode unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code bestimmt.

Stellt den Inhalt des Label im angegebenen Writer dar.

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

Syntax

'Declaration
Protected Friend Overrides Sub RenderContents ( _
    writer As HtmlTextWriter _
)
'Usage
Dim writer As HtmlTextWriter

Me.RenderContents(writer)

protected internal override void RenderContents (
    HtmlTextWriter writer
)

protected public:
virtual void RenderContents (
    HtmlTextWriter^ writer
) override

protected void RenderContents (
    HtmlTextWriter writer
)

protected internal override function RenderContents (
    writer : HtmlTextWriter
)

Parameter

writer
Der Ausgabestream, der HTML-Inhalt für den Client wiedergibt.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die RenderContents-Methode in einem benutzerdefinierten Serversteuerelement überschrieben wird, sodass ein bestimmter Text an Label angefügt wird.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom Label - RenderContents - VB.NET Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Label - RenderContents - VB.NET Example</h3>
            
            <aspSample:CustomLabelRenderContents id="Label1" runat="server" 
             ToolTip="Microsoft Corp.">Microsoft Corp.</aspSample:CustomLabelRenderContents>

        </form>
    </body>
</HTML>

...
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomLabelRenderContents
        Inherits System.Web.UI.WebControls.Label

        Protected Overrides Sub RenderContents(ByVal writer As System.Web.UI.HtmlTextWriter)

            ' Call the base RenderContents method.
            MyBase.RenderContents(writer)

            ' Append some text to the Label.
            writer.Write("<BR>Experience Windows Server 2003 and Visual Studio .NET 2003.")
        End Sub
    End Class

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom Label - RenderContents - C# Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Label - RenderContents - C# Example</h3>
            
            <aspSample:CustomLabelRenderContents 
              id="Label1" 
              runat="server" 
              ToolTip="Microsoft Corp.">Microsoft Corp.
            </aspSample:CustomLabelRenderContents>

        </form>
    </body>
</HTML>

...
using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomLabelRenderContents : System.Web.UI.WebControls.Label
  {
    protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
      // Call the base RenderContents method.
      base.RenderContents(writer);

      // Append some text to the Label.
      writer.Write("<BR>Experience Windows Server 2003 and Visual Studio .NET 2003.");
    }
  }
}

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom Label - RenderContents - VJ# Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Label - RenderContents - VJ# Example</h3>
            
            <aspSample:CustomLabelRenderContents 
              id="Label1" 
              runat="server" 
              ToolTip="Microsoft Corp.">Microsoft Corp.
            </aspSample:CustomLabelRenderContents>

        </form>
    </body>
</HTML>

...
package Samples.AspNet.JSL.Controls; 

public class CustomLabelRenderContents
    extends System.Web.UI.WebControls.Label
{
    protected void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
        // Call the base RenderContents method.
        super.RenderContents(writer);
        // Append some text to the Label.
        writer.Write("<BR>Experience Windows Server 2003 and " 
            + "Visual Studio .NET 2003.");
    } //RenderContents
} //CustomLabelRenderContents

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

Label-Klasse
Label-Member
System.Web.UI.WebControls-Namespace

Weitere Ressourcen

Label-Webserver-Steuerelement
Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen

Freigeben über