Compartir a través de


HyperLinkField Clase

Definición

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

public ref class HyperLinkField : System::Web::UI::WebControls::DataControlField
public class HyperLinkField : System.Web.UI.WebControls.DataControlField
type HyperLinkField = class
    inherit DataControlField
Public Class HyperLinkField
Inherits DataControlField
Herencia
HyperLinkField

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un HyperLinkField objeto para mostrar una columna de hipervínculos estáticos en un GridView control . Cada hipervínculo del HyperLinkField objeto comparte el mismo título y dirección URL de navegación especificado por las Text propiedades 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>

<%@ Page language="VB" %>

<!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 HyperLinkField objeto a campos de un origen de datos. Las DataTextField propiedades y DataNavigateUrlFields se usan para especificar los campos que se van a enlazar al título y a la dirección URL de navegación, respectivamente, de cada hipervínculo que se muestra en el HyperLinkField objeto .


<%@ 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>

<%@ Page language="VB" %>

<!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 DataTextFormatString and DataNavigateUrlFormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString 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>

Comentarios

Los controles enlazados a datos (como GridView y DetailsView) usan la HyperLinkField clase para mostrar un 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 HyperLinkField objeto se muestra de forma diferente según el control enlazado a datos en el que se use. Por ejemplo, el GridView control muestra un HyperLinkField objeto como una columna, mientras que el DetailsView control lo muestra como una fila.

Para especificar el título que se va a mostrar para los hipervínculos, use la Text propiedad . Utilice la NavigateUrl propiedad para especificar la dirección URL a la que navegar cuando se hace clic en un hipervínculo. Si desea mostrar el contenido vinculado en una ventana o marco específico, establezca la Target propiedad .

Nota

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

Como alternativa, puede enlazar el HyperLinkField objeto a campos de un origen de datos. Esto le permite mostrar un título diferente para cada hipervínculo del HyperLinkField objeto y hacer que cada hipervínculo navegue a una ubicación diferente. Para enlazar un campo a un título, establezca la DataTextField propiedad . Para crear una dirección URL para la navegación, establezca la DataNavigateUrlFields propiedad en una lista separada por comas de campos que se usará para crear la dirección URL.

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

Puede ocultar un HyperLinkField objeto en un control enlazado a datos estableciendo la Visible propiedad falseen .

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

Nota

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

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

Propiedad Style Descripción
ControlStyle La configuración de estilo para los controles secundarios del servidor web del HyperLinkField objeto .
FooterStyle La configuración de estilo de la sección de pie de página del HyperLinkField objeto .
HeaderStyle La configuración de estilo de la sección de encabezado del HyperLinkField objeto.
ItemStyle La configuración de estilo de los elementos de datos del HyperLinkField objeto .

Constructores

HyperLinkField()

Inicializa una nueva instancia de la clase HyperLinkField.

Propiedades

AccessibleHeaderText

Obtiene o establece el texto que se representa como el valor de la propiedad AbbreviatedText en algunos controles.

(Heredado de DataControlField)
Control

Obtiene una referencia al control de datos al que está asociado el objeto DataControlField.

(Heredado de DataControlField)
ControlStyle

Obtiene el estilo de cualquier control de servidor web contenido en el objeto DataControlField.

(Heredado de DataControlField)
DataNavigateUrlFields

Obtiene o establece los nombres de los campos del origen de datos utilizados para generar las direcciones URL de los hipervínculos del objeto HyperLinkField.

DataNavigateUrlFormatString

Obtiene o establece la cadena que especifica el formato con el que se representan las direcciones URL de los hipervínculos de un objeto HyperLinkField.

DataTextField

Obtiene o establece el nombre del campo del origen de datos que contiene el texto que se va a mostrar para los títulos de hipervínculo del objeto HyperLinkField.

DataTextFormatString

Obtiene o establece la cadena que especifica el formato con el que se muestran los títulos de hipervínculo en un objeto HyperLinkField.

DesignMode

Obtiene un valor que indica si un campo de control de datos está visible actualmente en un entorno en tiempo de diseño.

(Heredado de DataControlField)
FooterStyle

Obtiene o establece el estilo del pie de página del campo del control de datos.

(Heredado de DataControlField)
FooterText

Obtiene o establece el texto que se muestra en el elemento de pie de página de un campo de control de datos.

(Heredado de DataControlField)
HeaderImageUrl

Obtiene o establece la dirección URL de una imagen que se muestra en el elemento de encabezado de un campo de control de datos.

(Heredado de DataControlField)
HeaderStyle

Obtiene o establece el estilo del encabezado del campo del control de datos.

(Heredado de DataControlField)
HeaderText

Obtiene o establece el texto que se muestra en el elemento de encabezado de un campo de control de datos.

(Heredado de DataControlField)
InsertVisible

Obtiene un valor que indica si el objeto DataControlField está visible cuando su control enlazado a datos primario está en modo de inserción.

(Heredado de DataControlField)
IsTrackingViewState

Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista.

(Heredado de DataControlField)
ItemStyle

Obtiene el estilo de cualquier contenido basado en texto mostrado por un campo de control de datos.

(Heredado de DataControlField)
NavigateUrl

Obtiene o establece la dirección URL a la que se navega al hacer clic en un hipervínculo de un objeto HyperLinkField.

ShowHeader

Obtiene o establece un valor que indica si se representa el elemento de encabezado de un campo de control de datos.

(Heredado de DataControlField)
SortExpression

Obtiene o establece una expresión de ordenación utilizada por un control de origen de datos para ordenar los datos.

(Heredado de DataControlField)
Target

Obtiene o establece la ventana o el marco de destino donde se va a mostrar la página Web vinculada al hacer clic en un hipervínculo de un objeto HyperLinkField.

Text

Obtiene o establece el texto que se muestra para cada hipervínculo del objeto HyperLinkField.

ValidateRequestMode

Obtiene o establece un valor que especifica si el control valida la entrada de cliente.

(Heredado de DataControlField)
ViewState

Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto DataControlField en las distintas solicitudes de la misma página.

(Heredado de DataControlField)
Visible

Obtiene o establece un valor que indica si se representa un campo de control de datos.

(Heredado de DataControlField)

Métodos

CloneField()

Crea una copia duplicada del objeto actual derivado de DataControlField.

(Heredado de DataControlField)
CopyProperties(DataControlField)

Copia las propiedades del objeto HyperLinkField actual en el objeto especificado.

CreateField()

Devuelve una nueva instancia de la clase HyperLinkField.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrae el valor del campo de control de datos de la celda de la tabla actual y agrega su valor a la colección IDictionary especificada.

(Heredado de DataControlField)
FormatDataNavigateUrlValue(Object[])

Da formato a la dirección URL de navegación utilizando la cadena de formato que especifique la propiedad DataNavigateUrlFormatString.

FormatDataTextValue(Object)

Da formato al texto de título utilizando la cadena de formato que especifique la propiedad DataTextFormatString.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
Initialize(Boolean, Control)

Inicializa el objeto HyperLinkField.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicializa una celda en un objeto HyperLinkField.

LoadViewState(Object)

Restaura la vista del origen de datos tal y como se guardó previamente.

(Heredado de DataControlField)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnFieldChanged()

Genera el evento FieldChanged.

(Heredado de DataControlField)
SaveViewState()

Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor.

(Heredado de DataControlField)
ToString()

Devuelve una cadena que representa este objeto DataControlField.

(Heredado de DataControlField)
TrackViewState()

Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página.

(Heredado de DataControlField)
ValidateSupportsCallback()

Indica que los controles que contiene un objeto HyperLinkField admiten las devoluciones de llamada.

Implementaciones de interfaz explícitas

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtiene o establece el esquema asociado a este objeto DataControlField.

(Heredado de DataControlField)
IStateManager.IsTrackingViewState

Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista.

(Heredado de DataControlField)
IStateManager.LoadViewState(Object)

Restaura el estado de vista que se guardó previamente del campo de control de datos.

(Heredado de DataControlField)
IStateManager.SaveViewState()

Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor.

(Heredado de DataControlField)
IStateManager.TrackViewState()

Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página.

(Heredado de DataControlField)

Se aplica a

Consulte también