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。 此範例也會示範如何使用新的 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值。 不過，當 新增至 DataColumnCollectionDataTable 物件的 時DataColumn，它會指定預設名稱 (“Column1”、“Column2”，依此類) 。

根據預設，此值 Caption 會設定為 ColumnName 值。

另請參閱

• Caption
• 在 ADO.NET 中使用數據集