DataColumn.ColumnName Özellik

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Kaynak:

DataColumn.cs

içindeki DataColumnCollectionsütunun adını alır veya ayarlar.

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

Özellik Değeri

String

Sütunun adı.

Özel durumlar

ArgumentException

özelliği veya null olarak ayarlanır ve sütun bir koleksiyona aittir.

DuplicateNameException

Koleksiyonda aynı ada sahip bir sütun zaten var. Ad karşılaştırması büyük/küçük harfe duyarlı değildir.

Örnekler

Aşağıdaki örnekler, ColumnName içindeki her tablodaki her sütun için değerini DataSetalır. Örnekte ayrıca yeni ColumnNameile nasıl oluşturulacağı DataColumn gösterilmektedir.

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

Açıklamalar

DataColumn Oluşturulduğunda değeri yokturColumnName. Ancak, nesnesi DataTable için öğesine DataColumnCollection eklendiğinde DataColumn varsayılan bir ad verilir ("Sütun1", "Sütun2", vb.).

Varsayılan olarak, Caption değer değerine ayarlanır ColumnName .

Ayrıca bkz.

• Caption
• ADO.NET'de DataSet'leri Kullanma