DataColumn.ColumnName Свойство

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Исходный код:

DataColumn.cs

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

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

public string ColumnName { get; set; }

member this.ColumnName : string with get, set

Public Property ColumnName As String

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

String

Имя столбца.

Исключения

ArgumentException

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

DuplicateNameException

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

Примеры

В следующих примерах возвращается 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);
}

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 значение .

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

• Caption
• Использование наборов данных в ADO.NET