DataColumn.ColumnName Vlastnost

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Zdroj:

DataColumn.cs

Získá nebo nastaví název sloupce v 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

Hodnota vlastnosti

String

Název sloupce

Výjimky

ArgumentException

Vlastnost je nastavena na null nebo prázdný řetězec a sloupec patří do kolekce.

DuplicateNameException

Sloupec se stejným názvem již v kolekci existuje. Při porovnávání názvů se nerozlišuje velká a malá písmena.

Příklady

Následující příklady načte ColumnName hodnotu pro každý sloupec v každé tabulce DataSetv . Příklad také ukazuje, jak vytvořit DataColumn s novým 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

Poznámky

DataColumn Když je vytvořen, nemá žádnou ColumnName hodnotu. Když DataColumn se ale objekt přidá do objektu DataColumnCollectionDataTable , dostane výchozí název ("Sloupec1", "Sloupec2" atd.).

Ve výchozím nastavení Caption je hodnota nastavena na ColumnName hodnotu.

Viz také

• Caption
• Použití datových sad v ADO.NET