HtmlAnchor Server Control Declarative Syntax
Cria um controle de servidor que mapeia para o <a> elemento HTML e permite a você vincular a outra página da Web.
<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>
Comentários
Use o HtmlAnchor controle programaticamente o controle um <a> elemento HTML. O <a> elemento HTML permite criar um hiperlink que permite que você mova para outro local na página ou para outra página da Web. O HtmlAnchor controle deve estar bem formada com uma abertura e fechamento de marca. Você pode especificar a legenda para o controle, colocando texto entre as tags. O controle de servidor é usado para modificar dinamicamente os atributos e propriedades da <a> elemento, exibir os hyperlinks de uma fonte de dados e controle de eventos para gerar HtmlAnchor controla dinamicamente.
Você pode especificar o local para exibir a nova página da Web usando o Target propriedade. Targetvalores devem começar com uma letra no intervalo de um a z (maiúsculas de minúsculas), exceto os seguintes valores especiais que começam com um sublinhado: _blank, _self, _parent, and _top.
Você pode gerar dinamicamente o URL para a qual você deseja o HtmlAnchor o controle para o link. Para gerar o HRef propriedade dinamicamente, declare um controle HtmlAnchor em um documento HTML. Por exemplo:
<a id="anchor1" runat="server"></a>
<a id="anchor1" runat="server"></a>
Observação
Lembre-se de incorporar a HtmlAnchor controle dentro de marcas de abertura e fechamento de um HtmlForm de controle.
Em seguida, escreve um manipulador de eventos que atribui uma URL para o HRef propriedade da HtmlControl.
Embora o HtmlAnchor o controle não diretamente suporte a ligação a uma fonte de dados, é possível gerar hiperlinks a partir dos valores de um campo em uma fonte de dados. Primeiro ligar a fonte de dados a um controle de lista, como o Repeater. Em seguida declarar um HtmlAnchor controle dentro do controle de lista. Finalmente, adicione o código embutido para o valor da HRef propriedade que usa o Evalmétodo da DataBinder classe para especificar o campo para usar
Exemplo
O exemplo a seguir demonstra como associar dinamicamente uma URL com um HtmlAnchor controlam quando o Page_Load evento ocorre.
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";
}
O exemplo a seguir demonstra como incluir um HtmlAnchor de controle dentro de um Repeater de controle. Dados são ligados a Repeater controle, enquanto um HtmlAnchor controle é colocado no ItemTemplateque exibe o campo especificado na fonte de dados como um hiperlink.
<%@ 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>