HtmlAnchor.Name Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
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"/>).