System.Web.UI.WebControls.DataControlField Class

Serves as the base class for all data control field types, which represent a column of data in tabular data-bound controls such as System.Web.UI.WebControls.DetailsView and System.Web.UI.WebControls.GridView.

See Also: DataControlField Members


public abstract class DataControlField : System.Web.UI.IDataSourceViewSchemaAccessor, System.Web.UI.IStateManager


The System.Web.UI.WebControls.DataControlField class serves as the base class for all data control field types. Data control fields are used by data-bound controls to represent a field of data, similar to how a System.Web.UI.WebControls.DataGridColumn object represents a type of column in the System.Web.UI.WebControls.DataGrid control.

Use the classes that are derived from System.Web.UI.WebControls.DataControlField to control how a field of data is displayed in a data-bound control such as System.Web.UI.WebControls.DetailsView or System.Web.UI.WebControls.GridView. The following table lists the different data control field types provided by ASP.NET.


Displays the value of a field in a data source as text.


Displays a command button in a data-bound control. Depending on the control, this allows you to display either a row or a column with a custom button control, such as an Add or a Remove button.


Displays a check box in a data-bound control. This data control field type is commonly used to display fields with a Boolean value.


Displays built-in command buttons to perform edit, insert, or delete operations in a data-bound control.


Displays the value of a field in a data source as a hyperlink. This data control field type allows you to bind a second field to the hyperlink's URL.


Displays an image in a data-bound control.


Displays user-defined content in a data-bound control according to a specified template.

You can also extend the System.Web.UI.WebControls.DataControlField and System.Web.UI.WebControls.BoundField classes to create your own data control field types.

The System.Web.UI.WebControls.DataControlField class provides many properties that determine how user interface (UI) elements are presented in the data-bound control. Not every control uses every available data control field property when rendering a UI. For example, the System.Web.UI.WebControls.DetailsView control, which displays the data control fields as rows, includes a header item for each data control field, but no footer item. Therefore, the DataControlField.FooterText and DataControlField.FooterStyle properties are ignored by the System.Web.UI.WebControls.DetailsView control. The System.Web.UI.WebControls.GridView control, however, uses the DataControlField.FooterText and DataControlField.FooterStyle properties if the GridView.ShowFooter property is set to true. Similarly, the data control field properties affect the presentation of UI elements depending on what the element is. The DataControlField.ItemStyle property is always applied to the field. If the type derived from System.Web.UI.WebControls.DataControlField contains a control, as in the System.Web.UI.WebControls.ButtonField or System.Web.UI.WebControls.CheckBoxField classes, the DataControlField.ControlStyle property is applied to the field.


Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions:
Since: .NET 2.0