HyperLinkColumn Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Tipo de columna para el control DataGrid que contiene un hipervínculo para cada elemento de la columna.

public ref class HyperLinkColumn : System::Web::UI::WebControls::DataGridColumn

public class HyperLinkColumn : System.Web.UI.WebControls.DataGridColumn

type HyperLinkColumn = class
    inherit DataGridColumn

Public Class HyperLinkColumn
Inherits DataGridColumn

Herencia: Object

DataGridColumn
HyperLinkColumn

Ejemplos

En el ejemplo siguiente se muestra cómo crear un HyperLinkColumn objeto que se vincula a una página independiente.

Nota

En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de Web Forms, vea modelo de código de página ASP.NET Web Forms.

<%@ 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>HyperLinkColumn Example</title>
<script runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("PriceValue", typeof(Double)));
       
         for (int i = 0; i < 3; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = (Double)i * 1.23;

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {
         MyDataGrid.DataSource = CreateDataSource();
         MyDataGrid.DataBind();
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

<%@ 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>HyperLinkColumn Example</title>
<script runat="server">

      Function CreateDataSource() As ICollection 
      
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
         Dim i As Integer

         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("PriceValue", GetType(Double)))
       
         For i = 0 to 2 
         
            dr = dt.NewRow()

            dr(0) = i
            dr(1) = CDbl(i) * 1.23

            dt.Rows.Add(dr)

         Next i

         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function

      Sub Page_Load(sender As Object, e As EventArgs) 
    
         MyDataGrid.DataSource = CreateDataSource()
         MyDataGrid.DataBind()

      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

En el ejemplo correspondiente siguiente se muestra el elemento seleccionado en el ejemplo anterior.

<%@ 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>Details page for DataGrid</title>
<script runat="server">
 
      void Page_Load(Object sender, EventArgs e) 
      {
         Label1.Text = "You selected item: " + Request.QueryString["id"];
      }
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

<%@ 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>Details page for DataGrid</title>
<script runat="server">
 
      Sub Page_Load(sender As Object, e As EventArgs) 
      
         Label1.Text = "You selected item: " & Request.QueryString("id")
      
      End Sub
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

Comentarios

Use el HyperLinkColumn tipo de columna de un DataGrid control para crear un hipervínculo para cada fila de DataGrid. Establezca la Text propiedad para especificar el texto del título del hipervínculo. Para especificar la dirección URL a la que se va a vincular cuando se haga clic en el hipervínculo, establezca la NavigateUrl propiedad .

Nota

Si establece las Text propiedades y NavigateUrl , todos los hipervínculos de la columna compartirán el mismo título y dirección URL.

También puede enlazar el título de texto y la dirección URL de los hipervínculos de HyperLinkColumn a un campo de un origen de datos en lugar de establecer las Text propiedades y NavigateUrl . Esto le permite mostrar un título diferente y especificar una dirección URL diferente para cada hipervínculo de la columna.

Utilice la DataTextField propiedad para especificar un campo en un origen de datos para enlazar con el título de texto de los hipervínculos de la columna.

Nota

Las DataTextField propiedades y Text no se pueden establecer al mismo tiempo. Si se establecen ambas propiedades, la DataTextField propiedad tiene prioridad.

Especifique el campo que se va a enlazar a la dirección URL del hipervínculo estableciendo la DataNavigateUrlField propiedad .

Nota

Las DataNavigateUrlField propiedades y NavigateUrl no se pueden establecer al mismo tiempo. Si se establecen ambas propiedades, la DataNavigateUrlField propiedad tiene prioridad.

La Target propiedad permite especificar la ventana o marco para mostrar el contenido de la página web vinculado cuando se hace clic en el hipervínculo.

Al usar el enlace de datos, puede dar formato al título de texto y la dirección URL del hipervínculo estableciendo las DataTextFormatString propiedades y DataNavigateUrlFormatString , respectivamente.

Precaución

Este control se puede usar para mostrar la entrada del usuario, lo que podría incluir un script de cliente malintencionado. Compruebe cualquier información que se envíe desde un cliente para el script ejecutable, las instrucciones SQL u otro código antes de mostrarla en la aplicación. Puede usar controles de validación para comprobar la entrada del usuario antes de mostrar el texto de entrada en un control. ASP.NET proporciona una característica de validación de solicitudes de entrada para bloquear scripts y HTML en la entrada del usuario. Para obtener más información, vea Protección de controles estándar, Protección contra vulnerabilidades de seguridad de script en una aplicación web mediante la aplicación de codificación HTML a cadenas y validación de entradas de usuario en ASP.NET Web Pages.

Constructores

HyperLinkColumn()

Inicializa una nueva instancia de la clase HyperLinkColumn.

Propiedades

DataNavigateUrlField	Obtiene o establece el campo de un origen de datos que se va a enlazar con la dirección URL de los hipervínculos en el objeto HyperLinkColumn.
DataNavigateUrlFormatString	Obtiene o establece el formato de presentación de la dirección URL de los hipervínculos en el objeto HyperLinkColumn cuando la URL posee un enlace de datos con un campo en el origen de datos.
DataTextField	Obtiene o establece el campo de un origen de datos que se va a enlazar con el título de texto de los hipervínculos en el objeto HyperLinkColumn.
DataTextFormatString	Obtiene o establece el formato de presentación del título de texto de los hipervínculos de la columna HyperLinkColumn.
DesignMode	Obtiene un valor que indica si la columna está en modo de diseño. (Heredado de DataGridColumn)
FooterStyle	Obtiene las propiedades de estilo de la sección de pie de página de la columna. (Heredado de DataGridColumn)
FooterText	Obtiene o establece el texto que se muestra en la sección de pie de página de la columna. (Heredado de DataGridColumn)
HeaderImageUrl	Obtiene o establece la ubicación de una imagen que se va a mostrar en la sección de encabezado de la columna. (Heredado de DataGridColumn)
HeaderStyle	Obtiene las propiedades de estilo de la sección de encabezado de la columna. (Heredado de DataGridColumn)
HeaderText	Obtiene o establece el texto que se muestra en la sección de encabezado de la columna. (Heredado de DataGridColumn)
IsTrackingViewState	Obtiene un valor que determina si el objeto DataGridColumn se marca para que guarde su estado. (Heredado de DataGridColumn)
ItemStyle	Obtiene las propiedades de estilo de las celdas de elemento de la columna. (Heredado de DataGridColumn)
NavigateUrl	Obtiene o establece la dirección URL con la que se establece un vínculo cuando se hace clic en un hipervínculo de la columna.
Owner	Obtiene el control DataGrid del que forma parte la columna. (Heredado de DataGridColumn)
SortExpression	Obtiene o establece el nombre del campo o expresión que se va a pasar al método OnSortCommand(DataGridSortCommandEventArgs) cuando se selecciona una columna para ordenarla. (Heredado de DataGridColumn)
Target	Obtiene o establece la ventana o el marco de destino donde se ha de mostrar el contenido de la página Web a la que se vincula al hacer clic en el hipervínculo de la columna.
Text	Obtiene o establece el título de texto que se debe mostrar en los hipervínculos de la columna.
ViewState	Obtiene el objeto StateBag, que permite a una columna derivada de la clase DataGridColumn almacenar sus propiedades. (Heredado de DataGridColumn)
Visible	Obtiene o establece un valor que indica si se muestra la columna en el control DataGrid. (Heredado de DataGridColumn)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FormatDataNavigateUrlValue(Object)	Da formato a una dirección URL con enlace de datos mediante el formato especificado por la propiedad DataNavigateUrlFormatString.
FormatDataTextValue(Object)	Da formato a un título de texto con enlace de datos mediante el formato especificado por 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()	Proporciona la implementación base para restablecer una columna derivada de la clase DataGridColumn a su estado inicial.
InitializeCell(TableCell, Int32, ListItemType)	Inicializa la celda que representa esta columna con el hipervínculo contenido.
LoadViewState(Object)	Carga el estado del objeto DataGridColumn. (Heredado de DataGridColumn)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnColumnChanged()	Llama al método OnColumnsChanged(). (Heredado de DataGridColumn)
SaveViewState()	Guarda el estado actual del objeto DataGridColumn. (Heredado de DataGridColumn)
ToString()	Devuelve la representación de cadena de la columna. (Heredado de DataGridColumn)
TrackViewState()	Origina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor. (Heredado de DataGridColumn)

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState	Obtiene un valor que indica si la columna está efectuando un seguimiento de los cambios del estado de vista. (Heredado de DataGridColumn)
IStateManager.LoadViewState(Object)	Carga el estado guardado anteriormente. (Heredado de DataGridColumn)
IStateManager.SaveViewState()	Devuelve un objeto que contiene los cambios de estado. (Heredado de DataGridColumn)
IStateManager.TrackViewState()	Inicia el seguimiento de los cambios de estado. (Heredado de DataGridColumn)

Se aplica a

HyperLinkColumn Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Recursos adicionales