Sintaxis declarativa del control de servidor Web HyperLink

Actualización: noviembre 2007

Crea un vínculo en la página en el que pueden hacer clic los usuarios para moverse a otra 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"
/>

Comentarios

Utilice el control HyperLink para crear un vínculo que permita al usuario desplazarse a otra página u otra ubicación de la página. Para especificar la página o ubicación a la que se va a vincular, utilice la propiedad href. El vínculo puede mostrarse como texto o una imagen. Para mostrar texto, establezca la propiedad Text o coloque el texto entre las etiquetas de apertura y de cierre del control HyperLink. Para mostrar una imagen, establezca la propiedad ImageUrl.

Nota

Dado que el elemento <asp:HyperLink> no necesita tener contenido, se puede cerrar la etiqueta con /> en lugar de usar una etiqueta de cierre independiente.

Si establece las propiedades Text e ImageUrl, ImageUrl tendrá prioridad. Si no está disponible la imagen, se mostrará el texto de la propiedad Text. En los exploradores que admiten la función información sobre herramientas, se muestra el valor de la propiedad Text cuando se sitúa el puntero del mouse (ratón) encima del control HyperLink.

Para especificar el marco o la ventana en la que se va a mostrar la página vinculada, establezca la propiedad Target. Los valores deben empezar por una letra comprendida entre la a y la z (sin distinción entre mayúsculas y minúsculas), salvo los siguientes valores especiales que empiezan por un carácter de subrayado:

_blank

Muestra la página vinculada en una nueva ventana sin marcos.

_parent

Muestra la página vinculada en el conjunto de marcos principal inmediato.

_self

Muestra la página vinculada en el marco con foco.

_top

Muestra la página vinculada en una ventana completa sin marcos.

k0b15efk.alert_caution(es-es,VS.90).gifPrecaución:

El texto no se codifica en HTML antes de mostrarse en el control HyperLink. Esto permite incrustar una secuencia de comandos en las etiquetas HTML del texto. Si los valores del control provienen de la entrada del usuario, asegúrese de validar los valores para ayudar a evitar puntos vulnerables en la seguridad.

Para obtener información detallada sobre los eventos y propiedades del control de servidor Web HyperLink, consulte la documentación de HyperLink.

Al utilizar el control de servidor Web HyperLink para desplazarse entre las páginas de una aplicación, se puede utilizar el carácter comodín de la tilde ("~") para indicar la raíz de la aplicación sin tener que codificar un nombre de directorio en la dirección URL relativa de la aplicación. Por ejemplo, se puede utilizar "~/Default.aspx" para regresar a la página Default.aspx de la aplicación desde cualquier página de cualquier subdirectorio de la aplicación.

Ejemplo

En el ejemplo siguiente se muestra cómo utilizar un control HyperLink para ir a otra página 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>

Vea también

Referencia

HyperLink

Otros recursos

Sintaxis de los controles de servidor Web