Freigeben über


LinkButton.RenderContents-Methode

Rendert den Inhalt des Steuerelements im angegebenen Writer.

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
    Ein HtmlTextWriter, der den Ausgabestream für das Rendering des HTML-Inhalts auf dem Client darstellt.

Hinweise

Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

Beispiel

Das folgende Codebeispiel veranschaulicht das Überschreiben der RenderContents-Methode in einem benutzerdefinierten Serversteuerelement, sodass ein bestimmter Text an LinkButton angehängt wird.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom LinkButton - RenderContents - VB.NET Example</title>
        <script runat="server">
            Sub LinkButton1_Command(sender As Object, e As CommandEventArgs)
                ' Redirect to the Microsoft home page.
                Response.Redirect("https://www.microsoft.com/")
            End Sub
        </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom LinkButton - RenderContents - VB.NET Example</h3>
            
            <aspSample:CustomLinkButtonRenderContents id="LinkButton1" 
             runat="server" OnCommand="LinkButton1_Command" 
             ToolTip="Microsoft Home">Microsoft Corp.</aspSample:CustomLinkButtonRenderContents>

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

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

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

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

            ' Append some text to the LinkButton.
            writer.Write(" Home Page")
        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 LinkButton - RenderContents - C# Example</title>
    <script runat="server">
      void LinkButton1_Command(Object sender, CommandEventArgs e) 
      {
        // Redirect to the Microsoft home page.
        Response.Redirect("https://www.microsoft.com/");
      }
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom LinkButton - RenderContents - C# Example</h3>
            
            <aspSample:CustomLinkButtonRenderContents 
              id="LinkButton1" 
              runat="server" 
              OnCommand="LinkButton1_Command" 
              ToolTip="Microsoft Home">Microsoft Corp.
            </aspSample:CustomLinkButtonRenderContents>

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

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

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

      // Append some text to the LinkButton.
      writer.Write(" Home Page");
    }
  }
}
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom LinkButton - RenderContents - VJ# Example</title>
    <script runat="server">
        void LinkButton1_Command(Object sender, CommandEventArgs e) 
        {
            // Redirect to the Microsoft home page.
            get_Response().Redirect("https://www.microsoft.com/");
        } //LinkButton1_Command
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom LinkButton - RenderContents - VJ# Example</h3>
            
            <aspSample:CustomLinkButtonRenderContents 
              id="LinkButton1" 
              runat="server" 
              OnCommand="LinkButton1_Command" 
              ToolTip="Microsoft Home">Microsoft Corp.
            </aspSample:CustomLinkButtonRenderContents>

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

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

public class CustomLinkButtonRenderContents
    extends System.Web.UI.WebControls.LinkButton
{
    protected void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
        // Call the base RenderContents method.
        super.RenderContents(writer);
        // Append some text to the LinkButton.
        writer.Write(" Home Page");
    } //RenderContents
} //CustomLinkButtonRenderContents

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

LinkButton-Klasse
LinkButton-Member
System.Web.UI.WebControls-Namespace
HtmlTextWriter

Weitere Ressourcen

Button-Webserver-Steuerelemente