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, setPublic Property ColumnName As StringЗначение свойства
Имя столбца.
- Атрибуты
Исключения
Значение свойства равно 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);
}
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 значение .
