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