HtmlAnchor.Name Property

  • Reference

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Gets or sets the bookmark name defined in the HtmlAnchor server control.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };
public string Name { get; set; }
member this.Name : string with get, set
Public Property Name As String

Property Value

String

The bookmark name.

Examples

The following code example demonstrates how to use the Name property to mark different sections on the Web page, and link to them from a table of contents.

<%@ Page Language="C#" %>

<!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 runat="server">
    <title>Table of Contents</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

         <a id="TOC"/>
         <h2>Table of Contents</h2>
         <a href="#Topic1">Topic 1</a><br />
         <a href="#Topic2">Topic 2</a><br />
         <a href="#Topic3">Topic 3</a><br />
 
         <br /><br />
 
         <a id="Topic1"/>
            <h3>Topic 1</h3>
            <br /><br />
            Contents for first topic...
            <br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
            <a href="#TOC">Top</a><br />
        
         <a id="Topic2"/>
            <h3>Topic 2</h3>
            <br /><br />
            Contents for second topic...
            <br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
            <a href="#TOC">Top</a><br />
            <br />
         
 
         <a id="Topic3"/>
            <h3>Topic 3</h3>
            <br /><br />
            Contents for third topic...
            <br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
            <a href="#TOC">Top</a><br />
            <br /><br />

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

<%@ 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 runat="server">
    <title>Table of Contents</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

         <a id="TOC"/>
         <h2>Table of Contents</h2>
         <a href="#Topic1">Topic 1</a><br />
         <a href="#Topic2">Topic 2</a><br />
         <a href="#Topic3">Topic 3</a><br />
 
         <br /><br />
 
         <a id="Topic1"/>
            <h3>Topic 1</h3>
            <br /><br />
            Contents for first topic...
            <br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
            <a href="#TOC">Top</a><br />
        
         <a id="Topic2"/>
            <h3>Topic 2</h3>
            <br /><br />
            Contents for second topic...
            <br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
            <a href="#TOC">Top</a><br />
            <br />
         
 
         <a id="Topic3"/>
            <h3>Topic 3</h3>
            <br /><br />
            Contents for third topic...
            <br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
            <a href="#TOC">Top</a><br />
            <br /><br />

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

Remarks

Use this property to mark a section on a Web page with a name. This allows you to link to this section from anywhere on the same page. For example, you can provide a table of contents at the top of a page that will link directly to topics on the page.

To link to a marked section, use an HtmlAnchor control with the HRef property set to the name of the section, preceded by a # symbol (<a HRef= "#Topic1"/>).

Applies to

See also