DataControlField.Initialize(Boolean, Control) Method

Definition

Performs basic instance initialization for a data control field.

C#
public virtual bool Initialize(bool sortingEnabled, System.Web.UI.Control control);

Parameters

sortingEnabled
Boolean

A value that indicates whether the control supports the sorting of columns of data.

control
Control

The data control that owns the DataControlField.

Returns

Always returns false.

Remarks

The control that the DataControlField object is associated with calls the Initialize method to initialize the field before it is added to a rows collection. Data controls such as DetailsView and GridView call the Initialize method in their CreateChildControls methods before calling other methods such as CreateRow to create specific rows with data.

Call this method when you are writing a custom data-bound control that uses DataControlFieldCell objects to perform basic initialization for any DataControlField objects. Implement this method if your derived type requires any object initialization before it populates DataControlFieldCell objects with data or controls in the InitializeCell method.

Applies to

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1