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, "Rows")

Use the control to programmatically control the HTML <table> element on the server. This allows you to create a table on a Web page.

You can dynamically change the appearance of the <table> element by setting the , , , , and properties. You can also control how the content of a cell is displayed by setting the , , and properties.

The rows of the control are stored in the property of the control. This allows you to programmatically access the individual rows of the table.

A complex table model is not supported. You cannot have an control with nested <caption>, <col>, <colgroup>, <tbody>, <thead>, or <tfoot> elements. These elements are removed without warning and do not appear in the output HTML. An exception will be thrown if you attempt to programmatically add these table model elements to the collection of the control.

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

Allows programmatic access on the server to the HTML <table> element.

- Constructor

  Use this constructor to create and initialize a new instance of the class.

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

  Property

  Initial Value

  The "table" 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 alignment of the control in relation to other elements on the Web page.

  This property does not control the alignment of the contents in the cells of the control. To control the alignment of contents of an individual cell, use the and properties of the class. You can also control the alignment of contents of the cells in an entire row by using the and properties of the class.

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

  Value

  Description

  Left

  Aligns the control on the left edge of the Web page.

  Center

  Aligns the control in the middle of the Web page.

  Right

  Aligns the control on the right edge of the Web page.

  If you specify Left or Right alignment, other elements on the Web page will wrap to the right or left of the control, respectively. If you specify Center alignment, no wrapping occurs and other elements appear below the control.

  Gets or sets the alignment of the control in relation to other elements on the Web page.

  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 control. 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 control.

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

  Use the property to specify the width of the border. If you do not want to display a border for the control, set this property to either 0 (no border width) or -1 (border width is not set).

  Gets or sets the width (in pixels) of the border of the control.

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

  Use the property to specify the border color of the control. 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 control.

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

  Use the property to control the spacing between the contents of a cell and the cell's border. The padding amount specified is added to all four sides of the cell. All cells in a column share the same cell width; therefore, the spacing is applied to the widest cell in the column. Similarly, all cells in the same row share the same cell height. The spacing is applied to the tallest cell in the row. Individual cell sizes cannot be specified.

  Gets or sets the amount of space (in pixels) between the contents of a cell and the cell's border in the control.

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

  Use the property to control the spacing between individual cells in the control. This spacing is applied both vertically and horizontally.

  Gets or sets the amount of space (in pixels) between adjacent cells in the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Method
  System.Web.UI.ControlCollection

  The method creates a object that is used to hold table rows.

  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 control the height of the control. The height is normally specified in pixels. However, you can also specify a percentage of the browser window height by appending a percent sign (%) to the value. For example, the value 100% indicates a height for the table that is the full height of the browser window. The table automatically expands and contracts as the user changes the window size.

  If you specify a value that is smaller than is required to display the contents of the control, this property is ignored.

  Gets or sets the height of the control.

  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 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, 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 rendered HTML of the control easier to read by inserting a line return and indenting before rendering the control's child controls.

  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 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 additional formatting makes the rendered HTML of the control easier to read by inserting a line return after the closing <table> tag.

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

  Renders the control's end tag.

  The that receives the rendered content. 1.0.5000.0 2.0.0.0
- Property
  System.Web.UI.HtmlControls.HtmlTableRowCollection To be added: an object of type 'HtmlTableRowCollection'

  Use the collection to programmatically access the rows in the control. You can programmatically add rows to, remove rows from, or insert rows into the collection.

  If there are no <tr> elements listed in the control, an empty object is returned.

  Gets an collection that contains all the rows in the control.

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

  Use the property to control the width of the control. The width is normally specified in pixels. However, you can also specify a percentage of the browser window width by appending a percent sign (%) to the value. For example, the value 100% indicates a width for the table that is the full width of the browser window. The table automatically expands and contracts as the user changes the window size.

  If you specify a value that is smaller than is required to display the contents of the control, this property is ignored.

  Gets or sets the width of the control.

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