¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Text (Propiedad)

HyperLinkColumn.Text (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el título de texto que se debe mostrar en los hipervínculos de la columna.

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

public virtual string Text { get; set; }
/** @property */
public String get_Text()
/** @property */
public  void set_Text(String value)

public function get Text () : String
public function set Text (value : String)

Valor de propiedad

Tipo: System.String
Título de texto de los hipervínculos de la columna. El valor predeterminado es String.Empty.

La propiedad Text se utiliza para especificar el título de texto que se debe mostrar en los hipervínculos de la columna.

stse616c.alert_note(es-es,VS.90).gifNota:

Cuando se establece esta propiedad, todos los hipervínculos de la columna comparten el mismo título.

Para proporcionar a cada uno de los hipervínculos un título de texto independiente, utilice la propiedad DataTextField.

stse616c.alert_note(es-es,VS.90).gifNota:

Las propiedades DataTextField y Text no se pueden establecer a la vez. Si se establecen ambas propiedades, DataTextField tendrá prioridad.

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

El texto no se codifica en formato HTML hasta que se muestra en el objeto HyperLinkColumn. De esta forma se pueden incrustar secuencias de comandos en las etiquetas HTML del texto. Si los valores para esta columna los introduce el usuario, asegúrese de que los valida para reducir los puntos vulnerables de seguridad.

El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos utilizando una herramienta de diseñador. Para obtener más información, vea LocalizableAttribute y Globalización y adaptación en ASP.NET.

En el siguiente ejemplo se muestra cómo utilizar la propiedad Text para especificar los títulos de texto de los hipervínculos en el objeto HyperLinkColumn. Observe que todos los hipervínculos de la columna tienen el mismo título.

stse616c.alert_note(es-es,VS.90).gifNota:

El ejemplo de código siguiente utiliza un modelo de código de un solo archivo y puede no funcionar correctamente si se copia directamente en un archivo con el código subyacente. Se debe copiar este ejemplo de código en un archivo de texto vacío con la extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea Modelo de código de las páginas web ASP.NET.

<%@ 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"
                 NavigateUrl="detailspage.aspx"
                 Text="Click Me"
                 Target="_blank"/>

         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>



A continuación se muestra una página de un formulario Web Forms de ejemplo con la que se va a vincular al hacer clic en un hipervínculo del ejemplo anterior.

<%@ 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>
    <title>Details page for DataGrid</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>Details page for DataGrid</h3>

   Welcome to the new page.
</form> 
</body>
</html>



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft