System.Web 2.0.0.0 System.Web.UI.WebControls.TableRow System.Web.UI.IDataItemContainer

The class is used represent an individual row in a control. Each row in the control has a designated row type using the enumeration. The following table lists the different row types.

Row type

Description

DataRow

A data row in the control.

EmptyDataRow

The empty row in the control. The empty row is displayed when the control has no records to display and the template is not null.

Footer

The footer row in the control.

Header

The header row in the control.

Pager

A pager row in the control.

Separator

A separator row in the control.

To determine the row type of a object, use the property. A object also has a state associated with it. The state can be a bitwise combination of the values in the following table.

State value

Description

Alternate

The object is an alternate row in the control.

Edit

The object is in edit mode.

Normal

The object is in its normal (default) state.

Selected

The object is selected.

To determine the state of a object, use the property.

The control stores all of its data rows in the collection. To determine the index of a object in the collection, use the property.

You can access the properties of the underlying data object that is bound to the object by using the property.

The property is available only during and after the event of a control.

To determine the index of the data object in the underlying data source, use the property.

You can access the individual cells of the object by using the property. If a cell contains other controls, you can retrieve a control from the cell by using the collection of the cell. You can also use the method of the cell to find the control, if the control has an specified.

To retrieve a field value from a field column or an automatically generated field column, use the property of the cell. To retrieve a field value from other field column types where the field value is bound to a control, first retrieve the control from the appropriate cell and then access the appropriate property of the control.

It is possible to use a data-binding expression directly in a field column without binding the value to a property of a control. In this case, the field value is automatically placed in a control. To retrieve the field value, you must first retrieve the control from the appropriate cell and then use its property.

For a list of initial property values for an instance of , see the constructor.

Represents an individual row in a control.

- Constructor

  Use this constructor to initialize a new instance of a object.

  The following table shows initial property values for an instance of .

  Property

  Initial Value

  The value of the parameter.

  The value of the parameter.

  The value of the parameter.

  The value of the parameter.

  Initializes a new instance of the class.

  The index of the object in the collection of a control.
  The index of the in the underlying .
  One of the enumeration values.
  A bitwise combination of the enumeration values.
  2.0.0.0
- Property
  System.Object To be added.

  Use the property to access the properties of the underlying data object to which the object is bound. The property is only available during and after the event of a control.

  This property applies only to data rows.

  Gets the underlying data object to which the object is bound.

  2.0.0.0
- Property
  System.Int32 To be added.

  Use the property to determine the index of the in the underlying .

  This property applies only to data rows.

  Gets the index of the in the underlying .

  2.0.0.0
- Method
  System.Boolean `` `` To be added.

  Determines whether to pass an event up the page's ASP.NET server control hierarchy.

  true if the event has been canceled; otherwise, false.

  The source of the event. An object that contains the event data. 2.0.0.0
- Property
  System.Int32 To be added.

  Use the property to determine the index of the object in the collection of a control.

  This property applies only to data rows.

  Gets the index of the object in the collection of a control.

  2.0.0.0
- Property
  System.Web.UI.WebControls.DataControlRowState To be added.

  Use the property to determine the state of the object. The state can be a bitwise combination of the values in the following table:

  Status value

  Description

  DataControlRowState.Alternate

  The object is an alternate row in the control.

  DataControlRowState.Edit

  The object is in edit mode.

  DataControlRowState.Normal

  The object is in its normal (default) state.

  DataControlRowState.Selected

  The object is selected.

  This property is commonly used to determine the state of a row before performing an operation.

  Gets the state of the object.

  2.0.0.0
- Property
  System.Web.UI.WebControls.DataControlRowType To be added.

  Use the property to determine the type of row that the object represents. The following table lists the different row type values using the enumeration.

  Row type

  Description

  A data row in the control.

  The footer row in the control.

  The header row in the control.

  The empty row in the control. The empty row is displayed when control does not have any records to display.

  A pager row in the control.

  A separator row in the control.

  This property is commonly used to determine a row's type before performing an operation.

  Gets the row type of the object.

  2.0.0.0
- Property
  2.0.0.0
  System.Object To be added.

  This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface.

  For a description of this member, see .

- Property
  2.0.0.0
  System.Int32 To be added.

  This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface.

  For a description of this member, see .

- Property
  2.0.0.0
  System.Int32 To be added.

  This member is an explicit interface member implementation. It can be used only when the instance is cast to the interface.

  For a description of this member, see .