Esta documentación está archivada y no tiene mantenimiento.

HyperLinkField (Clase)

Representa un campo que se muestra como hipervínculo en un control con enlace a datos.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

public class HyperLinkField : DataControlField
public class HyperLinkField extends DataControlField
public class HyperLinkField extends DataControlField
No aplicable.

HyperLinkField es la clase que utilizan los controles con enlace a datos (como GridView y DetailsView) para presentar una hipervínculo para cada registro mostrado. Cuando el usuario hace clic en un hipervínculo, se le dirige a la página Web asociada al hipervínculo. El objeto HyperLinkField se muestra de forma diferente en función del control con enlace a datos donde se utiliza. Por ejemplo, el control GridView muestra un objeto HyperLinkField como una columna, mientras que el control DetailsView lo muestra como una fila.

Para especificar el título que se va a mostrar para los hipervínculos, utilice la propiedad Text. Use la propiedad NavigateUrl para especificar la dirección URL a la que desplazarse al hacer clic en el hipervínculo. Si desea mostrar el contenido vinculado en una ventana o marco concretos, establezca la propiedad Target.

NotaNota:

Cuando se establecen las propiedades Text y NavigateUrl, todos los hipervínculos del objeto HyperLinkField comparten el mismo título y dirección URL de desplazamiento. Igualmente, la propiedad Target también se aplica a todos los hipervínculos.

De manera alternativa, puede enlazar el objeto HyperLinkField a campos de un origen de datos. Esto permite mostrar un título diferente para cada hipervínculo del objeto HyperLinkField y para que cada hipervínculo se desplace a una ubicación distinta. Para enlazar un campo a un título, establezca la propiedad DataTextField. Para crear una dirección URL para desplazarse, establezca la propiedad DataNavigateUrlFields en una lista separada por comas de campos para utilizar de cara a crear la dirección URL.

Puede especificar un formato personalizado para los títulos y direcciones URL de desplazamiento estableciendo las propiedades DataTextFormatString y DataNavigateUrlFormatString, respectivamente.

Puede ocultar un objeto HyperLinkField en un control con enlace a datos estableciendo la propiedad Visible en false.

Las secciones de encabezado y pie de página de un objeto HyperLinkField se pueden personalizar. Para mostrar un título en la sección de encabezado o pie de página, establezca las propiedades HeaderText o FooterText, respectivamente. Para mostrar una imagen en la sección de encabezado, en lugar de un texto, establezca la propiedad HeaderImageUrl. La sección de encabezado puede ocultarse en el objeto HyperLinkField estableciendo la propiedad ShowHeader en false.

NotaNota:

Algunos controles con enlace a datos (como el control GridView) pueden mostrar u ocultar únicamente toda la sección de encabezado del control. Estos controles con enlace a datos no admiten la propiedad ShowHeader para un campo enlazado individual. Para mostrar u ocultar toda la sección de encabezado de un control con enlace a datos, utilice la propiedad ShowHeader del control (si está disponible).

También puede personalizar la apariencia del objeto HyperLinkField (color de fuente, color de fondo, etc.) estableciendo las propiedades de estilo para las distintas partes del campo. En la siguiente tabla se muestran las diferentes propiedades de estilo.

Propiedad de estilo

Descripción

ControlStyle

Configuración de estilo para los controles secundarios de servidor Web del objeto HyperLinkField.

FooterStyle

Configuración de estilo para la sección de pie de página del objeto HyperLinkField.

HeaderStyle

Configuración de estilo para la sección de encabezado del objeto HyperLinkField.

ItemStyle

Configuración de estilo para los elementos de datos del objeto HyperLinkField.

En el ejemplo de código siguiente se muestra cómo utilizar un objeto HyperLinkField para presentar una columna de hipervínculos estáticos en un control GridView. Cada hipervínculo del objeto HyperLinkField comparte el mismo título y dirección URL de desplazamiento que especifican las propiedades Text y NavigateUrl, respectivamente.


<%@ 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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


En el ejemplo de código siguiente se muestra cómo enlazar un objeto HyperLinkField a los campos de un origen de datos. Las propiedades DataTextField y DataNavigateUrlFields se utilizan para especificar los campos para enlazar el título y la dirección URL de desplazamiento, respectivamente, de cada uno de los hipervínculos que se muestran en el objeto HyperLinkField.


<%@ 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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- The UnitPrice field values are bound to the         -->
      <!-- captions of the hyperlinks in the HyperLinkField    -->
      <!-- field column, formatted as currency. The ProductID  -->
      <!-- field values are bound to the navigate URLs of the  -->
      <!-- hyperlinks. However, instead of being the actual    -->
      <!-- URL values, the product ID is passed to the linked  -->
      <!-- page as a parameter in the URL specified by the     -->
      <!-- DataNavigateUrlFormatString property.               -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="Order ID"/>
          <asp:boundfield datafield="ProductID" 
            headertext="Product ID"/>
          <asp:hyperlinkfield datatextfield="UnitPrice"
            datatextformatstring="{0:c}"
            datanavigateurlfields="ProductID"
            datanavigateurlformatstring="~\details.aspx?ProductID={0}"          
            headertext="Price"
            target="_blank" />
          <asp:boundfield datafield="Quantity" 
            headertext="Quantity"/>
                 
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


  • AspNetHostingPermission  para trabajar en un entorno alojado en host. Valor de petición: LinkDemand; valor de permiso: Minimal.
  • AspNetHostingPermission  para trabajar en un entorno alojado en host. Valor de petición: InheritanceDemand; valor de permiso: Minimal.

System.Object
   System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.HyperLinkField

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: