System.Web.UI.WebControls.HyperLink Class

A control that displays a link to another Web page.

See Also: HyperLink Members

Syntax

[System.ComponentModel.Designer("System.Web.UI.Design.WebControls.HyperLinkDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner")]
[System.ComponentModel.DefaultProperty("Text")]
[System.Web.UI.ToolboxData("<{0}:HyperLink runat="server">HyperLink</{0}:HyperLink>")]
[System.Web.UI.ParseChildren(false)]
[System.Web.UI.DataBindingHandler("System.Web.UI.Design.HyperLinkDataBindingHandler, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.Web.UI.ControlBuilder(typeof(System.Web.UI.WebControls.HyperLinkControlBuilder))]
public class HyperLink : WebControl

Remarks

In this topic:

Introduction

Use the System.Web.UI.WebControls.HyperLink control to create a link to another Web page. The System.Web.UI.WebControls.HyperLink control is typically displayed as text specified by the HyperLink.Text property. It can also be displayed as an image specified by the HyperLink.ImageUrl property.

If both the HyperLink.Text and HyperLink.ImageUrl properties are set, the HyperLink.ImageUrl property takes precedence. If the image is unavailable, the text in the HyperLink.Text property is displayed. In browsers that support ToolTip functionality, the HyperLink.Text property also becomes the ToolTip.

Note:

This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see [<topic://cpconASPNETSyntaxForValidationControls>].

Accessibility

For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio 2010 and ASP.NET 4 and ASP.NET Controls and Accessibility.

Declarative Syntax

Example

<asp:HyperLink
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0