System.Web.UI.WebControls Namespace

---

.NET Framework version 2.0

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

DataControlField Class Members

Show Inherited Members

Properties Visibility Name Value Type Accessibility public AccessibleHeaderText String [ Get , Set ] public ControlStyle Style [ Get ] public FooterStyle TableItemStyle [ Get ] public FooterText String [ Get , Set ] public HeaderImageUrl String [ Get , Set ] public HeaderStyle TableItemStyle [ Get ] public HeaderText String [ Get , Set ] public InsertVisible Boolean [ Get , Set ] public ItemStyle TableItemStyle [ Get ] public ShowHeader Boolean [ Get , Set ] public SortExpression String [ Get , Set ] public Visible Boolean [ Get , Set ]   Methods Visibility Name Parameters Return Type protected CopyProperties ( DataControlField newField ) Void protected CreateField ( ) DataControlField public ExtractValuesFromCell ( IOrderedDictionary dictionary , DataControlFieldCell cell , DataControlRowState rowState , Boolean includeReadOnly ) Void public Initialize ( Boolean sortingEnabled , Control control ) Boolean public InitializeCell ( DataControlFieldCell cell , DataControlCellType cellType , DataControlRowState rowState , Int32 rowIndex ) Void protected LoadViewState ( Object savedState ) Void protected OnFieldChanged ( ) Void protected SaveViewState ( ) Object public ToString ( ) String protected TrackViewState ( ) Void public ValidateSupportsCallback ( ) Void

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

The following table lists the different data control field types provided by ASP.NET.

Column field type	Description
BoundField	Displays the value of a field in a data source as text.
ButtonField	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.
CheckBoxField	Displays a check box in a data-bound control. This data control field type is commonly used to display fields with a Boolean value.
CommandField	Displays built-in command buttons to perform edit, insert, or delete operations in a data-bound control.
HyperLinkField	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.
ImageField	Displays an image in a data-bound control.
TemplateField	Displays user-defined content in a data-bound control according to a specified template.

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

The 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 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 FooterText and FooterStyle properties are ignored by the DetailsView control. The GridView control, however, uses the FooterText and FooterStyle properties if the 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 ItemStyle property is always applied to the field. If the type derived from DataControlField contains a control, as in the ButtonField or CheckBoxField classes, the ControlStyle property is applied to the field.

BoundField   ButtonField   CheckBoxField   CommandField   HyperLinkField   ImageField   TemplateField

Suggested Reading