Share via

hiperlink controle de servidor Web Declarative sintaxe

  • Artigo

Cria um link na página que os usuários podem clicar para ir para outra página.

<asp:HyperLink
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageUrl="uri"
    href="uri"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    Text="string"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>

Comentários

Use o HyperLink controle para criar um link que você move para outra página ou local na página. Especifique a página ou o local para vincular a usando o href propriedade. O link ou pode ser exibido sistema autônomo texto ou uma imagem. Para exibir texto, ou conjunto o Text propriedade ou o texto entre as Rótulos de abertura e fechamento do local a HyperLink controle. Para exibir uma imagem conjunto o ImageUrl propriedade.

ObservaçãoObservação:

Porque o <asp:HyperLink> elemento não é necessário ter conteúdo, você pode fechar a marca com /> em vez de usar uma marca de fechamento separada.

Se o Text e ImageUrl propriedades forem definidas, o ImageUrl propriedade tem precedência. Se a imagem não estiver disponível, o texto a Text propriedade, em seguida, é exibida. Em navegadores que oferecem suporte ao recurso dicas de ferramentas, o valor de Text propriedade é exibida quando o ponteiro do mouse for colocado sobre o HyperLink controle.

Você pode especificar o quadro ou janela para exibir a página vinculada, definindo o Target propriedade. Valores devem começar com uma letra no intervalo da a z (sem distinção entre maiúsculas e minúsculas), exceto para os seguintes valores especiais que começam com um sublinhado:

_blank

Exibe a página vinculada em uma nova janela sem quadros.

_parent

Exibe a página vinculada no pai imediato do conjunto de quadros.

_self

Exibe a página vinculada no quadro com foco.

_top

Exibe a página vinculada na janela inteira sem quadros.

Aviso

O texto não é codificado antes que seja exibido em HTML a Controle HyperLink Isso torna possível incorporar o script nas Rótulos HTML no texto. Se os valores para o controle provenientes da entrada do usuário, certifique-se de validar os valores para ajudar a evitar vulnerabilidades de segurança.

Para obter informações detalhadas sobre o HyperLink Propriedades e eventos de controle de servidor de Web, consulte o HyperLink documentação.

Ao usar o HyperLinkControle de servidor Web para navegar entre páginas em seu aplicativo, você pode usar o til ("~") curinga para indicar a raiz do seu aplicativo sem a necessidade de codificar um nome de diretório para o URL relativo do aplicativo. Por exemplo, você poderia usar "~ / padrão.aspx" para navegar de volta à página padrão.aspx do seu aplicativo de qualquer página em qualquer subdiretório no aplicativo.

Exemplo

O exemplo a seguir demonstra como usar um HyperLink controle para mover para outra página da Web.

<%@ 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>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>


<%@ Page Language="C#" 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>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>


<%@ Page Language="JScript" 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>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">

  <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>

Consulte também

Referência

HyperLink

Outros recursos

controle de servidor Web sintaxe