DataGridTextBoxColumn Constructor (PropertyDescriptor, String)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Initializes a new instance of a DataGridTextBoxColumn with the specified PropertyDescriptor and format.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public DataGridTextBoxColumn(
	PropertyDescriptor prop,
	string format


Type: System.ComponentModel.PropertyDescriptor

The PropertyDescriptor for the column with which the DataGridTextBoxColumn will be associated.

Type: System.String

The format used to format the column values.

Use this constructor to create a custom format for the displayed data.

The DataGridColumnStyle uses a PropertyDescriptor to determine the type of data displayed in the column. To return a PropertyDescriptorCollection, use the GetItemProperties method of the BindingManagerBase class.

For more information about formatting characters, see Formatting Types in the .NET Framework and Custom Date and Time Format Strings.

The following code example demonstrates the use of this member.

private void MyAddCustomDataTableStyle()
   // Get the currency manager for 'myDataSet'.
   CurrencyManager myCurrencyManger =

   DataGridTableStyle myTableStyle = new DataGridTableStyle();
   myTableStyle.MappingName = "Customers";

   PropertyDescriptor proprtyDescriptorName =

   DataGridColumnStyle myCustomerNameStyle =
            new DataGridTextBoxColumn(proprtyDescriptorName);

   myCustomerNameStyle.MappingName = "custName";
   myCustomerNameStyle.HeaderText = "Customer Name";

   // Add style for 'Date' column.
   PropertyDescriptor myDateDescriptor =
   // 'G' is for MM/dd/yyyy HH:mm:ss date format.
   DataGridColumnStyle myDateStyle =
            new DataGridTextBoxColumn(myDateDescriptor,"G");

   myDateStyle.MappingName = "Date";
   myDateStyle.HeaderText = "Date";
   myDateStyle.Width = 150;

   // Add DataGridTableStyle instances to GridTableStylesCollection.

.NET Framework
Available since 1.1
Return to top