HtmlTableCell class properties and its descriptions

This class represents the <td> (data cell) and <th> (table heading cell) HTML elements in an HtmlTableRow object. The HtmlTableCell class allows Web developers to customize the appearance of a cell in a table by specifying the background color, the border color, the height, and the width. These attributes are set using the BgColor, BorderColor, Height, and Width properties.

Web developers can control how the content of a cell is displayed by specifying the vertical and horizontal alignment of the contents. They can also specify whether the content automatically continues on the next line when the end of the cell is reached. The horizontal alignment is controlled by the Align property, while the VAlign property controls the vertical alignment. The NoWrap property indicates whether text wrapping is disabled. By using the ColSpan or the RowSpan property, they can control the number of columns or rows that a cell occupies.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in System.Web.dll)

Property

Description

Supported in .NET version

Adapter

This property gets the browser-specific adapter for the control. If the target browser does not require an adapter, returns a null reference (Nothing in VB.NET). The property returns the ControlAdapter object that renders the control on the requesting device or browser’s screen.

2.0, 3.0, 3.5, 4.0

Align

This string property gets or sets the horizontal alignment of the content in the cell represented by an instance of the HtmlTableCell class. Its default value is String.Empty, which indicates that this property is not set. Note: Setting this property affects only the cell represented by an instance of the HtmlTableCell class. To apply the same alignment to the cells of an entire row in the table, Web developer should set the Align property of the row represented by an instance of the HtmlTableRow class. Web developer can use one of the following values for this property:

–          Left – Aligns the contents of a cell with the left edge of the cell.

–          Center – Aligns the contents of a cell in the middle of the cell.

–          Right -Aligns the contents of a cell with the right edge of the cell.

–          Justify, Char – if browser supports them.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

AppRelativeTemplateSourceDirectory

 

Software developer can use this property to set or get the application-relative path to the page or user control that contains the current control.  If the web page is installed in http://www.somesite.com/apps/application1 the property will return “~/application1”.

2.0, 3.0, 3.5, 4.0

Attributes

Web developer can use this property to get a collection of all attribute name and value pairs expressed on a server control tag within the ASP.NET page. Using this property Web developer accesses the attributes of the HTML server control which are stored in Control.ViewState property. HTML attributes are treated by the .NET Framework as properties on the HTML server control to which they belong.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

BgColor

This string property is used to get or set the background color of the cell represented by an instance of the HtmlTableCell class. Web developer can determine a color either by name or by using a hexadecimal value, preceded by the pound character (#), in the form #RRGGBB. RR, GG, and BB represent hexadecimal values from 0 to 255 that indicate the red, green, and blue components of a color, respectively.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

BindingContainer

Software developer can’t use this property directly from his/her code, because it supports the .NET Framework infrastructure.  The property contains a reference to the Control object which contains data-binding information for the current control.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

BoderColor

This string property is used to get or set the border color of the cell represented by an instance of the HtmlTableCell class. Web developer can determine a color either by name or by using a hexadecimal value, preceded by the pound character (#), in the form #RRGGBB. RR, GG, and BB represent hexadecimal values from 0 to 255 that indicate the red, green, and blue components of a color, respectively.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

ChildControlsCreated

Gets a true value that indicates whether the server control’s child controls have been created.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

ClientID

Returns the server control identifier generated by ASP.NET. The ClientID value is generated by concatenating the ID value of the control and the UniqueID value of its parent control. If the ID value of the control is not specified, an automatically generated value is used. Each part of the generated ID is separated by an underscore character (_).

1.0,1.1, 2.0, 3.0, 3.5, 4.0

ClientIDSeparator

The ClientID value is generated by concatenating the ID value of the control and the UniqueID value of its parent control. Each part of the generated ID property is separated by the ClientIDSeparator property value. The value always returns an underscore (_).

1.0,1.1, 2.0, 3.0, 3.5, 4.0

ColSpan

This property gets or sets the number of columns occupied by a cell represented by an instance of the HtmlTableCell class. Its default value is -1, which indicates that this property is not set. Web developer can use this property to create a cell in the table that occupies more than one column. Note: When spanning columns, Web developer should be sure to define one fewer cell in the row for each column that he/she spans. For example, if he/she spans two columns, defines one fewer cell in the current row. Otherwise, that row will be longer than the number of columns in the table and the table will not be displayed as expected.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Context

Software developer can use this property to access the HttpContext object for the current Web request. Using properties of the object software developer can access objects Application, Session, Request, Response, etc. which contain information about the current HTTP request. The object provides methods that allow him to get configuration information and to set or clear errors related to the request.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Controls

This property allows software developer to access programmatically to the instance of the ControlCollection class for any server control. Using it he/she can add/remove controls to/from the collection or iterate through the server controls in the collection.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

DesignMode

This property returns true to indicate that the control is being used in the context of a designer. Software developer’s custom controls can use this property when design-time behavior is different than run-time behavior.

2.0, 3.0, 3.5, 4.0

Disabled

This property is used to get or set a value indicating whether the HTML server control is disabled. Its default value is false i.e. the control is enabled. In the browser, a disabled element or control is read-only, with the following added restrictions:

– its value is not submitted with the form,

– the element or control cannot receive focus

– the element or control is skipped when navigating the document by tabbing.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

EnableTheming

This property overrides Control. EnableTheming.

The property indicates whether themes are enabled for a specified control. When the property’s value is true, the application’s theme directory is searched for control skins to apply. If for the particular control skin does not exist in the directory, skins are not applied. When the property’s value is false, the theme directory is not searched and the contents of the SkinID property are not used.

2.0, 3.0, 3.5, 4.0

EnableViewState

Software developer must enable view state for the server control setting its value to true if he/she wants to maintain its state across HTTP requests. Sometimes is better to set value of this property to false if for example Web application is loading a database request into a server control. In this case application performance will be improved.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Events

This read-only property returns a list of event handler delegates for the control. The type of this property is EventHadlerList, which uses a linear search algorithm to find entries in the list of delegates. When the list of delegates is large, finding entries with this property will be slow, because a linear search algorithm is inefficient when working with a large number of entries.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

HasChildViewState

Software developer can use this property to verify that any child controls of the server control are storing view-state information. Using it in this way he/she can avoid unnecessary calls to the ClearChildViewState method.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Height

This string property gets or sets the height (in pixels) of the cell represented by an instance of the HtmlTableCell class. Its default value is String.Empty, which indicates that this property is not set. When Web developer specifies the height of a cell, all cells in the same row automatically share that height. Note: If Web developer specifies a height that is smaller than is required to display the contents of the cell, this property is ignored.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

ID

Web developers can set this property by declaring ID attribute in the opening tag of an ASP.NET server control. Another possible way to set it is programmatically. If this property is not specified for a server control, either declaratively or programmatically, Web developer can obtain a reference to the control through its parent control’s Controls property.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

IdSeparator

Software developer can’t use this property directly from his/her code, because it supports the .NET Framework infrastructure.   The character contained in this property ( by default $ ) is used to separate the control identifiers for child controls. The ID separator character is appended to the ID property.

2.0, 3.0, 3.5, 4.0

InnerHtml

This property gets or sets (modifies) the content found between the opening and closing tags of the specified HTML server control. The property does not automatically encode special characters to and from HTML entities. HTML entities allow Page developers to display special characters, such as the < character, that a browser would ordinarily interpret as having special meaning. The < character would be interpreted as the start of a tag and is not displayed on the page. To display the < character, Page developer should use the entity &lt;.

Note: Because the text is not HTML encoded, it possible to embed script within HTML tags in the text. If this property is set dynamically using user input, Web developers should be sure to validate the value to reduce security vulnerabilities.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

InnerText

This property gets or sets (modifies) the text between the opening and closing tags of the specified HTML server control. Unlike the InnerHtml property, the InnerText property automatically encodes special characters to and from HTML entities. HTML entities allow Page developers to display special characters, such as the < character, that a browser would ordinarily interpret as having special meaning. The < character would be interpreted as the start of a tag and is not displayed on the page. To display the < character, they should use the entity &lt;.

Note: If there are no child controls, the InnerHtml property contains the value String.Empty.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

IsChildControlStateCleared

This property has value true if children of this control do not use control state; otherwise, false.

2.0, 3.0, 3.5, 4.0

IsTrackingViewState

This property returns value true if the control is marked to save changes to its view state; otherwise, false.

 

1.0,1.1, 2.0, 3.0, 3.5, 4.0

IsViewStateEnabled

This property returns value true if view state is enabled for the control; otherwise false.  View state can be enabled at the page, container, or control level. When view state is disabled at the page or container level, view state is disabled for all controls contained by the page or container. The property indicates whether view state is enabled by pages, containers, or controls. In some cases it is possible values for the EnableViewState property and the IsViewStateEnabled property to be different. For example, if the Page containing the control has view state disabled, the EnableViewState property can be true while the IsViewStateEnabled property is false. Notes: Developers will set the EnableViewState property to indicate whether they are using view state with your control. Web developers can use this property in their code to determine whether view state is enabled for their control and all containers.

2.0, 3.0, 3.5, 4.0

LoadViewStateByID

This property returns value true if the control loads its view state by ID; otherwise, false. Its default value is false.

2.0, 3.0, 3.5, 4.0

NamingContainer

Using this property software developer can get a reference to the server control’s naming container, which creates a unique namespace for differentiating between server controls with the same Control.ID property value.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

NoWrap

This Boolean property is used to get or set a value indicating whether the text in a cell represented by an instance of the HtmlTableCell class automatically continues on the next line when it reaches the end of the cell. Its default value is false.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Page

Provides a reference to the web page that contains this control as a System.Web.UI.Page object.  This property’s value reflects the name of the .aspx file that contains the server control.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Parent

This property provides a reference to the control that contains this control. If the control is placed on the page directly (rather than inside another control), it will return a reference to the page object.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

RowSpan

This property is used to get or set the number of rows occupied by a cell represented by an instance of the HtmlTableCell class. Its default value is -1,  which indicates that this property is not set. Web developer can use this property to create a cell in the table that occupies more than one row. Note: When spanning rows, Web developer should be sure to define one fewer cell in the column for each row that he/she spans. For example, if he/she spans two rows, defines one fewer cell in that column. Otherwise, that column will be longer than the number of rows in the table and the table will not be displayed as expected.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Site

Using this property software developer can get information about the container that hosts the current control when rendered on a design surface.  A site binds a Component object to a Container object and enables communication between the two. It also provides a way for the container to manage its components.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

SkinID

This property overrides Control.SkinID.

Web developer can get or set the skin to apply to the control.  Skins available to a control are contained in one or more skin files in a theme directory. The SkinID property specifies which of these skins to apply to the control. A skin is specific to a particular control i.e. software developer cannot share skin setting between controls of different types. If developer does not set the SkinID property, a control uses the default skin if one is defined.

2.0, 3.0, 3.5, 4.0

Style

Web developer can use this property to get a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control. This property will render on all browsers for all controls.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

TagName

Web developers can use this property to get the name of the control tag. This property is used primarily by control developers.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

TemplateControl

This property is used to get or set a reference to the template that contains this control.

2.0, 3.0, 3.5, 4.0

TemplateSourceDirectory

Software developer can use this property to get the path to the page or user control that contains the current control.  If the web page is installed in http://www.somesite.com/apps/application1 the property will return “apps/application1”.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

UniqueID

This property can be used to get the unique, hierarchically qualified identifier for the server control. This property differs from the ID property, in that the UniqueID property includes the identifier for the server control’s naming container. This identifier is generated automatically when a page request is processed. This property is particularly important in differentiating server controls contained within a data-binding server control that repeats as Repeater, DataList, DetailsView, FormView, and GridView Web server controls.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

VAlign

This string property is used to get or set the vertical alignment for the content of a cell represented by an instance of the HtmlTableCell class. Its default value is String.Empty, which indicates that this property is not set. Note: Setting this property affects only the cell represented by an instance of the HtmlTableCell class. To apply the same vertical alignment to the cells of an entire row in the table, Web developer should set the VAlign property of the row represented by an instance of the HtmlTableRow class. Web developer can use one of the following values for this property:

–          Top – Aligns the contents of a cell with the upper edge of the cell.

–          Middle – Aligns the contents of a cell in the center of the cell.

–          Bottom – Aligns the contents of a cell with the lower edge of the cell.

–          Baseline – not all browsers support this feature.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

ViewState

Web developers can use this property to get a dictionary of state information that allows them to save and restore the view state of a server control across multiple requests for the same page.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

ViewStateIgnoresCase

This property returns true if StateBag object is insensitive; otherwise, false. Its default value is false.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Visible

Web developers can use this property to get or set a value that indicates whether a server control is rendered as UI on the page. If the control is visible on the page this property will has value true; otherwise false.

1.0,1.1, 2.0, 3.0, 3.5, 4.0

Width

This property is used to get or set the width (in pixels) of the cell represented by an instance of the HtmlTableCell class. Its default value is String.Empty, which indicates that this property is not set. Note: If a width that is smaller than is required to display the contents of the cell, is specified, this property is ignored.

1.0,1.1, 2.0, 3.0, 3.5, 4.0