DataColumn.ColumnName 属性

定义

获取或设置 DataColumnCollection 中的列的名称。

public string ColumnName { get; set; }
[System.Data.DataSysDescription("DataColumnColumnNameDescr")]
public string ColumnName { get; set; }

属性值

列的名称。

属性

例外

属性设置为 null 或空字符串,且列属于一个集合。

集合中已经存在同名称的列。 名称比较不区分大小写。

示例

以下示例获取 ColumnName 中每个表中每个列的 DataSet。 该示例还演示如何使用新的 ColumnName创建 DataColumn

private void PrintColumnNames(DataSet dataSet)
{
    // For each DataTable, print the ColumnName.
    foreach(DataTable table in dataSet.Tables)
    {
        foreach(DataColumn column in table.Columns)
        {
            Console.WriteLine(column.ColumnName);
        }
    }
}

private void AddColumn(DataTable table)
{
    DataColumn column;
    column = new DataColumn();
    column.ColumnName = "SupplierID";
    column.DataType = System.Type.GetType("System.String");
    column.Unique = true;
    column.AutoIncrement = false;
    column.Caption = "SupplierID";
    column.ReadOnly = false;

    // Add the column to the table's columns collection.
    table.Columns.Add(column);
}

注解

DataColumn创建 时,它没有任何ColumnName值。 但是,将 DataColumn 添加到 对象的 时DataColumnCollectionDataTable,会为其指定默认名称 (“Column1”、“Column2”等) 。

默认情况下,该值 Caption 设置为 ColumnName 值。

适用于

产品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 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
.NET Standard 2.0, 2.1

另请参阅