How to: Add HyperLink Web Server Controls to a Web Forms Page
You can add a hyperlink to your Web Forms page by placing a HyperLink Web server control on the page and associating it with a URL. You can specify that HyperLink controls render as either text or as graphics.
To add a HyperLink Web server control to a Web Forms page
-
Add an
<asp:HyperLink>element to the page. For syntax, see HyperLink Web Server Control Declarative Syntax. -
Specify the format of the link in the page by doing one of the following:
-
To create a text link, set the control's Text property. You can include HTML formatting in the property. For example, you can format an individual word in the text as bold by placing a
<B>tag around it in the Text property. -
To create a graphical link, set the control's ImageUrl property to the URL of a .gif, .jpg, or other Web graphic file.
Note If you set both the ImageUrl and Text properties, the ImageUrl property takes precedence.
-
-
Set the NavigateUrl property to the URL of the page to which you want to link.
Security Note The URL that is associated with a hyperlink points to an external resource. If you point to a resource that you do not own, be sure it is safe for your users to work with. For more information, see How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings.
-
Optionally, set the ID of a target window or frame in which to display the linked page. You can either specify a window by name or use predefined target values, such as
_top,_parent, and so on.
Note You can change the appearance of the link text — for example, whether it is underlined — by using styles. For details, see ASP.NET Web Server Controls and CSS Styles.
The following example shows how you can set the properties of a HyperLink control at run time. The method handles a Button control's Click event and sets the control's link text and target page.
Protected Sub Button1_Click(ByVal sender As Object, _ ByVal e As System.EventArgs) Handles Button1.Click Hyperlink1.Text = "Home" Hyperlink1.NavigateUrl = "http://www.contoso.com" End Sub
protected void Button1_Click (object sender, System.EventArgs e) { this.HyperLink1.Text = "Home"; this.HyperLink1.NavigateUrl = "http://www.contoso.com"; }