System.Web.UI.WebControls.DataList.ExtractTemplateRows Property

Gets or sets a value that indicates whether the rows of a System.Web.UI.WebControls.Table control, defined in each template of a System.Web.UI.WebControls.DataList control, are extracted and displayed.

Syntax

[System.ComponentModel.DefaultValue(false)]
public virtual bool ExtractTemplateRows { set; get; }

Value

Documentation for this section has not yet been entered.

Remarks

The contents of the System.Web.UI.WebControls.DataList control are specified by using templates. Normally, you list controls that you want to display in the templates. You can also place a System.Web.UI.WebControls.Table control in a template and display the rows of the table.

Use the DataList.ExtractTemplateRows property to specify whether the rows of a System.Web.UI.WebControls.Table control defined in each template of a System.Web.UI.WebControls.DataList control are extracted and displayed. All rows extracted from the templates of the System.Web.UI.WebControls.DataList control are displayed in a single table. This allows you to create a single table from other smaller tables and still maintain the features of the System.Web.UI.WebControls.DataList control.

Note:

When this property is set to true, you must provide a well-formed System.Web.UI.WebControls.Table control for each template you want to include in the System.Web.UI.WebControls.DataList control. Only the rows of the tables will be displayed. All other content in the template will be ignored. You must use a System.Web.UI.WebControls.Table control for this feature to work properly. The System.Web.UI.HtmlControls.HtmlTable control is not compatible with this property.

When you create a cell for a System.Web.UI.WebControls.Table control in a template, you can use the TableCell.ColumnSpan property of the System.Web.UI.WebControls.TableCell object to control the number of columns the cell spans. You can also use the TableCell.RowSpan property to control the number of rows the cell spans.

Note:

The DataList.RepeatColumns, DataList.RepeatDirection, and DataList.RepeatLayout properties do not affect the appearance of the System.Web.UI.WebControls.DataList control when this property is set to true.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0