HyperLink.RenderContents Method (System.Web.UI.WebControls)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

.NET Framework Class Library

HyperLink.RenderContents Method

Displays the HyperLink control on a page.

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

Syntax

Visual Basic

Protected Friend Overrides Sub RenderContents ( _
	writer As HtmlTextWriter _
)

protected internal override void RenderContents(
	HtmlTextWriter writer
)

Visual C++

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

abstract RenderContents : 
        writer:HtmlTextWriter -> unit 
override RenderContents : 
        writer:HtmlTextWriter -> unit

Parameters

writer: Type: System.Web.UI.HtmlTextWriter
The output stream to render on the client.

Examples

The following code example demonstrates how to override the RenderContents method in a custom server control so that some text is appended to the HyperLink control.

Visual Basic


<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>Custom HyperLink - RenderContents - VB.NET Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom HyperLink - RenderContents - VB.NET Example</h3>

            <aspSample:CustomHyperLinkRenderContents 
             id="HyperLink1" runat="server" Target="_blank"
             NavigateUrl="http://www.microsoft.com/"  
             ToolTip="Microsoft Web Site">www.microsoft.com
            </aspSample:CustomHyperLinkRenderContents>

        </form>
    </body>
</html>


<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>Custom HyperLink - RenderContents - C# Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom HyperLink - RenderContents - C# Example</h3>

            <aspSample:CustomHyperLinkRenderContents 
              id="HyperLink1" runat="server" Target="_blank"
              NavigateUrl="http://www.microsoft.com/"  
              ToolTip="Microsoft Web Site">www.microsoft.com
            </aspSample:CustomHyperLinkRenderContents>

        </form>
    </body>
</html>

Visual Basic


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

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

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

        ' Append some text to the HyperLink.
        writer.Write(" Home Page")
    End Sub
End Class


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

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

      // Append some text to the HyperLink.
      writer.Write(" Home Page");
    }
  }
}

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

HyperLink Class

System.Web.UI.WebControls Namespace

Other Resources

HyperLink Web Server Control Overview