Export (0) Print
Expand All

DataColumn::ColumnName Property

Gets or sets the name of the column in the DataColumnCollection.

Namespace:  System.Data
Assembly:  System.Data (in System.Data.dll)

public:
property String^ ColumnName {
	String^ get ();
	void set (String^ value);
}

Property Value

Type: System::String
The name of the column.

ExceptionCondition
ArgumentException

The property is set to nullptr or an empty string and the column belongs to a collection.

DuplicateNameException

A column with the same name already exists in the collection. The name comparison is not case sensitive.

When a DataColumn is created, it has no ColumnName value. However, when the DataColumn is added to a DataColumnCollection for a DataTable object, it is given a default name ("Column1", "Column2", and so on).

By default, the Caption value is set to the ColumnName value.

The following examples gets the ColumnName for every column in every table in a DataSet. The example also shows how to create a DataColumn with a new ColumnName.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft