This documentation is archived and is not being maintained.

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 property String^ Text {
	String^ get ();
	void set (String^ value);
}

Property Value

Type: System::String
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.

NoteNote

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.

NoteNote

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.

NoteNote

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.

No code example is currently available or this language may not be supported.

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

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: