DataColumn.ColumnName Свойство

Определение

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

public:
 property System::String ^ ColumnName { System::String ^ get(); void set(System::String ^ value); };
public string ColumnName { get; set; }
[System.Data.DataSysDescription("DataColumnColumnNameDescr")]
public string ColumnName { get; set; }
member this.ColumnName : string with get, set
[<System.Data.DataSysDescription("DataColumnColumnNameDescr")>]
member this.ColumnName : string with get, set
Public Property ColumnName As String

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

Имя столбца.

Атрибуты

Исключения

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

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

Примеры

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

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);
}
Private Sub PrintColumnNames(dataSet As DataSet)
    Dim table As DataTable
    Dim column As DataColumn 

    ' For each DataTable, print the ColumnName.
    For Each table in dataSet.Tables
        For Each column in table.Columns
        Console.WriteLine(column.ColumnName)
        Next
    Next
End Sub

Private Sub AddColumn(table As DataTable)
    Dim column As DataColumn
    column = New DataColumn()

    With column
        .ColumnName = "SupplierID"
        .DataType = System.Type.GetType("System.String")
        .Unique = True
        .AutoIncrement = False
        .Caption = "SupplierID"
        .ReadOnly = False
    End With

    ' Add the column to the table's columns collection.
    table.Columns.Add(column)
End Sub

Комментарии

DataColumn При создании он не ColumnName имеет значения. Однако при DataColumn добавлении DataColumnCollection объекта DataTable в объект присваивается имя по умолчанию ("Column1", "Column2" и т. д.).

По умолчанию Caption для значения задано ColumnName значение.

Применяется к

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