DataColumn.ColumnName 属性
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置 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。 该示例还演示如何使用新的 ColumnName创建 DataColumn 。
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 添加到 对象的 时DataColumnCollectionDataTable，会为其指定默认名称 (“Column1”、“Column2”等) 。
默认情况下，该值 Caption 设置为 ColumnName 值。
| 产品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
