DataColumn.ColumnName Eigenschaft

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Ruft den Namen der Spalte in der DataColumnCollection ab oder legt diesen fest.

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, set
Public Property ColumnName As String

Eigenschaftswert

String

Der Name der Spalte.

Attribute
DataSysDescriptionAttribute

Ausnahmen

ArgumentException

Die Eigenschaft ist auf null oder eine leere Zeichenfolge festgelegt, und die Spalte gehört zu einer Auflistung.

DuplicateNameException

Eine Spalte mit demselben Namen ist bereits in der Auflistung vorhanden. Beim Namensvergleich wird die Groß- und Kleinschreibung nicht berücksichtigt.

Beispiele

In den folgenden Beispielen wird für ColumnName jede Spalte in jeder Tabelle in einer .DataSet Das Beispiel zeigt auch, wie Sie eine mit DataColumn einem neuen ColumnNameErstellen erstellen.

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

Hinweise

Wenn ein DataColumn Erstellt wird, hat er keinen ColumnName Wert. Wenn das DataColumn Objekt jedoch einem DataColumnCollection DataTable Objekt hinzugefügt wird, erhält er einen Standardnamen ("Column1", "Column2" usw.).

Standardmäßig wird der Caption Wert auf den ColumnName Wert festgelegt.

Gilt für

Siehe auch