Прочитать на английском

Поделиться через


DataColumn.ColumnName Свойство

Определение

Возвращает или задает имя столбца в DataColumnCollection.

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

Значение свойства

Имя столбца.

Атрибуты

Исключения

Значение свойства равно null или пустой строке, и столбец принадлежит коллекции.

Столбец с таким именем уже существует в коллекции. Сравнение имени выполняется без учета регистра.

Примеры

В следующих примерах возвращается ColumnName для каждого столбца в каждой DataSetтаблице в . В примере также показано, как создать DataColumn с новым ColumnName.

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 в DataColumnCollection объект для DataTable объекта ему присваивается имя по умолчанию ("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

См. также раздел