DataColumn.ColumnName Свойство

Определение

Возвращает или задает имя столбца в DataColumnCollection.Gets or sets the name of the column in the 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

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

String

Имя столбца.The name of the column.

Атрибуты

Исключения

Значение свойства равно null или пустой строке, и столбец принадлежит коллекции.The property is set to null or an empty string and the column belongs to a collection.

Столбец с таким именем уже существует в коллекции.A column with the same name already exists in the collection. Сравнение имени выполняется без учета регистра.The name comparison is not case sensitive.

Примеры

В следующих примерах получается ColumnName для каждого столбца в каждой таблице в DataSet .The following examples gets the ColumnName for every column in every table in a DataSet. В примере также показано, как создать объект DataColumn с новым ColumnName .The example also shows how to create a DataColumn with a new 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 значения.When a DataColumn is created, it has no ColumnName value. Однако при DataColumn добавлении к DataColumnCollection DataTable объекту для объекта ему присваивается имя по умолчанию («Столбец1», «Столбец2» и т. д.).However, when the DataColumn is added to a DataColumnCollection for a DataTable object, it is given a default name ("Column1", "Column2", and so on).

По умолчанию Caption задано значение ColumnName .By default, the Caption value is set to the ColumnName value.

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

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