System.Web 1.0.5000.0 2.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.Web.UI.HtmlControls.HtmlContainerControl System.Web.UI.ParseChildren(true, "Cells")

The <tr> element represents a row in a table. Use the class to programmatically control the <tr> HTML elements in an control.

The class allows you to customize the appearance of a row in a table by specifying the background color, the border color, and the height of the cells in the row. These attributes are set using the , , and properties.

You can control the alignment of the contents in the cells for the entire row by using the and properties. The property controls the horizontal alignment of the contents of the cells, while the property controls the vertical alignment.

By using the collection of this class, you can programmatically access the individual cells in a row of a table. This allows you to control the properties of each cell, as well as the content.

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

Represents the <tr> HTML element in an control.

- Constructor

  Use this constructor to create and initialize a new instance of the class. This constructor is used to create an object that represents the <tr> element for a table row.

  The following table shows the initial property value for an instance of .

  Property

  Initial Value

  The "tr" literal string.

  Initializes a new instance of the class.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the horizontal alignment of the content in the cells of a row in an control.

  Setting this property affects all cells in a row of a table represented by an instance of the class. To apply an alignment attribute to a single cell of a row, set the property for that cell.

  The following table lists the values that can be used for this property.

  Value

  Description

  Left

  Aligns the contents of the cell with the left edge of the cell.

  Center

  Aligns the contents of the cell in the middle of the cell.

  Right

  Aligns the contents of the cell with the right edge of the cell.

  You can also use Justify and Char as values for this property. However, not all browsers support these features.

  Gets or sets the horizontal alignment of the content in the cells of a row in an control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the background color of the row represented by an instance of the class. You can specify 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. For example, the value #0000FF represents the color blue. It specifies the minimum value (00) for the red and green components, while specifying the maximum value (FF) for the blue component.

  The following table shows the sixteen predefined HTML color names and corresponding hexadecimal values that can be used for the property. For more information on HTML colors, see the World Wide Web Consortium (W3C) Web site.

  Color name

  Hexadecimal value

  Aqua

  #00FFFF

  Black

  #000000

  Blue

  #0000FF

  Fuchsia

  #FF00FF

  Gray

  #808080

  Green

  #008000

  Lime

  #00FF00

  Maroon

  #800000

  Navy

  #000080

  Olive

  #808000

  Purple

  #800080

  Red

  #FF0000

  Silver

  #C0C0C0

  Teal

  #008080

  White

  #FFFFFF

  Yellow

  #FFFF00

  The available colors for use with the property can be determined from the enumeration.

  Color names are case-insensitive.

  Gets or sets the background color of the row represented by an instance of the class.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the border color of the row represented by an instance of the class. You can specify 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. For example, the value #0000FF represents the color blue. It specifies the minimum value (00) for the red and green components, while specifying the maximum value (FF) for the blue component.

  The following table shows the sixteen predefined HTML color names and corresponding hexadecimal values that can be used for the property. For more information on HTML colors, see the World Wide Web Consortium (W3C) Web site.

  Color name

  Hexadecimal value

  Aqua

  #00FFFF

  Black

  #000000

  Blue

  #0000FF

  Fuchsia

  #FF00FF

  Gray

  #808080

  Green

  #008000

  Lime

  #00FF00

  Maroon

  #800000

  Navy

  #000080

  Olive

  #808000

  Purple

  #800080

  Red

  #FF0000

  Silver

  #C0C0C0

  Teal

  #008080

  White

  #FFFFFF

  Yellow

  #FFFF00

  The available colors for use with the property can be determined from the enumeration.

  Color names are case-insensitive.

  Gets or sets the border color of the row represented by an instance of the class.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Property
  System.Web.UI.HtmlControls.HtmlTableCellCollection To be added: an object of type 'HtmlTableCellCollection'

  Use the collection to programmatically access the cells of a row in an control. You can programmatically add, remove, and insert cells in the collection.

  If there are no cells defined in a row, an empty object is returned.

  Gets a collection of objects that represent the cells contained in a row of the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.Browsable(false)
- Method
  System.Web.UI.ControlCollection

  The method creates a new collection that is used to hold the row cells.

  The method is primarily of interest to control developers extending the functionality of the control.

  Creates a new object for the control.

  A that contains the control's child server controls.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the height (in pixels) of the cell represented by an instance of the class. All cells in the row share the same height.

  If you specify a height that is smaller than is required to display the contents of the cells in the row of a table, this property is ignored.

  Gets or sets the height (in pixels) of the row represented by an instance of the class.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Property
  System.String a

  Do not read from or assign a value to this property. Otherwise, a exception is thrown. This property is inherited from the class and is not applicable to the class.

  Gets or sets the content between the opening and closing tags of the control without automatically converting special characters to their equivalent HTML entities. This property is not supported for this control.

  1.0.5000.0
  2.0.0.0
- Property
  System.String a

  Do not read from or assign a value to this property. Otherwise, a exception is raised. This property is inherited from the class and is not applicable to the class.

  Gets or sets the content between the opening and closing tags of the control with automatic conversion of special characters to their equivalent HTML entities. This property is not supported for this control.

  1.0.5000.0
  2.0.0.0
- Method
  System.Void ``

  The method provides additional formatting before and after calling the base class's method. The additional formatting makes the control's rendered HTML easier to read by adding a line return and indenting before rendering the control's child objects.

  The method is used primarily by control developers extending the functionality of the control.

  Renders the control's child controls to the specified object.

  The object that receives the rendered content. 1.0.5000.0 2.0.0.0
- Method
  System.Void ``

  The method provides additional formatting after calling the base class's method. The added formatting makes the control's rendered HTML easier to read by adding a line return after the closing <tr> tag.

  The method is used primarily by control developers extending the functionality of the control.

  Renders the control's end tag.

  The object that receives the rendered content. 1.0.5000.0 2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the vertical alignment of the content in the cells of a row in an control.

  Setting this property affects all cells in a row of a table represented by an instance of the class. To apply an alignment attribute to a single cell of a row, set the property for that cell.

  The following table lists the values that can be used for this property.

  Value

  Description

  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.

  You can also use BaseLine as a value for this property. However, not all browsers support this feature.

  Gets or sets the vertical alignment of the content in the cells of a row in an control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")