HyperLinkColumn.Text Property

Gets or sets the text caption to display for the hyperlinks in the column.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in 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)

Not applicable.

Property Value

The text caption for the hyperlinks in the column. The default value is String.Empty.

Use the Text property to specify the text caption to display for the hyperlinks in the column.


When this property is set, all hyperlinks in the column share the same text caption.

To provide a separate text caption for each hyperlink in the column, use the DataTextField property.


The DataTextField and Text properties cannot both be set at the same time. If both properties are set, the DataTextField property takes precedence.

Caution noteCaution:

Text is not HTML encoded before it is displayed in the HyperLinkColumn. This makes it possible to embed script within HTML tags in the text. If the values for this column come from user input, be sure to validate the values to reduce security vulnerabilities.

The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

The following example demonstrates how to use the Text property to specify the text caption for hyperlinks in the HyperLinkColumn. Notice that all hyperlinks in the column have the same text caption.


The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Page Code Model.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="http://www.w3.org/1999/xhtml" >

    <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;


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

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




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

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 

         <HeaderStyle BackColor="#aaaadd"/>


                 HeaderText="Select an Item"
                 Text="Click Me"




The following corresponding example is a sample Web Forms page to link to when a hyperlink in the previous example is clicked.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="http://www.w3.org/1999/xhtml" >
    <title>Details page for DataGrid</title>
<form id="Form1" runat="server">
   <h3>Details page for DataGrid</h3>
   Welcome to the new page.

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions