2 out of 4 rated this helpful - Rate this topic

DataColumn::ColumnName Property

.NET Framework 3.5

Other Versions

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

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

Syntax

C++

JScript

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

Property Value

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

Exceptions

Exception	Condition
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.

Remarks

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.

Examples

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.

C++

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

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information