TableCell.Text Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the text contents of the cell.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Bindable(true)]
public virtual string Text { get; set; }

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)]
public virtual string Text { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, set

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)>]
member this.Text : string with get, set

Public Overridable Property Text As String

Property Value

String

The text contents of the cell. The default value is Empty.

Attributes: BindableAttribute PersistenceModeAttribute

Examples

The following code example demonstrates how to create a new instance of a TableCell control programmatically. In particular, note how the Text property is used for setting the contents of the TableCell control.

This code example is part of a larger example provided for the TableCell class.

// Create more rows for the table.
for (int rowNum = 2; rowNum < 10; rowNum++)
{
    TableRow tempRow = new TableRow();
    for (int cellNum = 0; cellNum < 3; cellNum++)
    {
        TableCell tempCell = new TableCell();
        tempCell.Text = 
            String.Format("({0},{1})", rowNum, cellNum);
        tempRow.Cells.Add(tempCell);
    }
    Table1.Rows.Add(tempRow);
}

' Create more rows for the table.
Dim rowNum As Integer
For rowNum = 2 To 9
    Dim tempRow As New TableRow()
    Dim cellNum As Integer
    For cellNum = 0 To 2
        Dim tempCell As New TableCell()
        tempCell.Text = _
            String.Format("({0},{1})", rowNum, cellNum)
        tempRow.Cells.Add(tempCell)
    Next
    Table1.Rows.Add(tempRow)
Next

Remarks

Use the Text property to specify or determine the text contents of the cell. This property is commonly used to programmatically update the contents of a cell.

Note

Setting the Text property will clear any other controls contained in the TableCell.

Caution

The Text control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Validating User Input in ASP.NET Web Pages.

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 Globalization and Localization.

Applies to

Jaa