HtmlAnchor 服务器控件声明性语法
[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
创建一个服务器端控件，该控件映射到 <a> HTML 元素并允许您链接到其他网页。
<a
EnableViewState="False|True"
Href="string"
Id="string"
Title="string"
Visible="False|True"
OnDataBinding="OnDataBinding event handler"
OnDisposed="OnDisposed"
OnInit="OnInit event handler"
OnLoad="OnLoad event handler"
OnPreRender="OnPreRender event handler"
OnServerClick="OnServerClick event handler"
OnUnload="OnUnload event handler"
runat="server"
>
linkText
</a>
备注
使用 HtmlAnchor 控件以编程方式控制 <a> HTML 元素。 使用 <a> HTML 元素可以创建允许您移到页上的其他位置或其他网页的超链接。 HtmlAnchor 控件必须使用带有开始和结束标记的正确格式。 您可以通过将文本放置在开始和结束标记之间来指定控件标题。 此服务器控件通常用于动态修改 <a> 元素的特性和属性，显示来自数据源的超链接以及控制事件以动态生成 HtmlAnchor 控件。
通过使用 Target 属性，可以指定显示新网页的位置。 除了下列以下划线开头的特殊值之外，Target 值必须以一个 a 到 z 范围内的字母（不区分大小写）开头：_blank、_self、_parent 和 _top。
可以动态生成希望 HtmlAnchor 控件链接到的 URL。 若要动态生成 HRef 属性，请在 HTML 文档中声明 HtmlAnchor 控件。 例如：
<a id="anchor1" runat="server"></a>
<a id="anchor1" runat="server"></a>
备注
请记住，将 HtmlAnchor 控件嵌入 HtmlForm 控件的开始标记和结束标记内部。
下一步，编写一个事件处理程序来向 HtmlControl 的 HRef 属性分配一个 URL。
虽然 HtmlAnchor 控件不直接支持绑定到数据源，但可以从数据源中的字段值生成超链接。 首先将数据源绑定到列表控件，如 Repeater。 然后在列表控件内部声明一个 HtmlAnchor 控件。 最后添加 HRef 属性值的内联代码，该代码使用 DataBinder 类的 Eval 方法指定要使用的字段。
示例
下面的示例演示当 Page_Load 事件发生时，如何动态地将一个 URL 与 HtmlAnchor 控件相关联。
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
anchor1.HRef = "https://www.microsoft.com"
End Sub
void Page_Load(object sender, EventArgs e)
{
anchor1.HRef = "https://www.microsoft.com";
}
下面的示例演示如何在 Repeater 控件中包含 HtmlAnchor 控件。 将数据绑定到 Repeater 控件，并将 HtmlAnchor 控件放置在将数据源中的指定字段显示为超链接的 ItemTemplate 中。
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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>HtmlAnchor Control</title>
</head>
<script runat="server">
Sub Page_Load(sender As Object, e As EventArgs)
Dim dt As New DataTable()
Dim dr As DataRow
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
dt.Columns.Add(New DataColumn("DateTimeValue", GetType(DateTime)))
dt.Columns.Add(New DataColumn("BoolValue", GetType(Boolean)))
dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
Dim i As Integer
For i = 0 To 8
dr = dt.NewRow()
dr(0) = i
dr(1) = "Item " + i.ToString()
dr(2) = DateTime.Now
If i Mod 2 <> 0 Then
dr(3) = True
Else
dr(3) = False
End If
dr(4) = 1.23 *(i + 1)
dt.Rows.Add(dr)
Next i
MyRepeater.DataSource = New DataView(dt)
MyRepeater.DataBind()
End Sub
</script>
<body>
<h3>Data Binding with the HtmlAnchor</h3>
<br />
<form id="Form1" runat="server">
<asp:Repeater id="MyRepeater" runat="server">
<ItemTemplate>
Link for
<a id="A1" href='<%# DataBinder.Eval(Container, _
"DataItem.StringValue", _
"detailspage.aspx?id={0}") %>'
runat="server">
<%# DataBinder.Eval(Container, "DataItem.StringValue") %>
</a>
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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>HtmlAnchor Control</title>
</head>
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
dt.Columns.Add(new DataColumn("DateTimeValue", typeof(DateTime)));
dt.Columns.Add(new DataColumn("BoolValue", typeof(bool)));
dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
for (int i = 0; i < 9; i++)
{
dr = dt.NewRow();
dr[0] = i;
dr[1] = "Item " + i.ToString();
dr[2] = DateTime.Now;
dr[3] = (i % 2 != 0) ? true : false;
dr[4] = 1.23 * (i+1);
dt.Rows.Add(dr);
}
MyRepeater.DataSource=new DataView(dt);
MyRepeater.DataBind();
}
</script>
<body>
<h3>Data Binding with the HtmlAnchor</h3>
<br />
<form id="Form1" runat="server">
<asp:Repeater id="MyRepeater" runat="server">
<ItemTemplate>
Link for
<a id="A1" href='<%# DataBinder.Eval(Container,
"DataItem.StringValue",
"detailspage.aspx?id={0}") %>'
runat="server">
<%# DataBinder.Eval(Container, "DataItem.StringValue") %>
</a>
<br />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>