DataColumn.ColumnName Eigenschaft

Definition

Ruft den Namen der Spalte in der DataColumnCollection ab oder legt diesen fest.Gets or sets the name of the column in the DataColumnCollection.

public:
 property System::String ^ ColumnName { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("DataColumnColumnNameDescr")]
public string ColumnName { get; set; }
member this.ColumnName : string with get, set
Public Property ColumnName As String

Eigenschaftswert

Der Name der Spalte.The name of the column.

Attribute

Ausnahmen

Die Eigenschaft ist auf null oder eine leere Zeichenfolge festgelegt, und die Spalte gehört zu einer Auflistung.The property is set to null or an empty string and the column belongs to a collection.

Eine Spalte mit demselben Namen ist bereits in der Auflistung vorhanden.A column with the same name already exists in the collection. Beim Namensvergleich wird die Groß- und Kleinschreibung nicht berücksichtigt.The name comparison is not case sensitive.

Beispiele

In den folgenden Beispielen wird ColumnName der für jede Spalte in jeder Tabelle in DataSeteiner abgerufen.The following examples gets the ColumnName for every column in every table in a DataSet. Das Beispiel zeigt auch, wie ein DataColumn mit einem neuen ColumnNameerstellt wird.The example also shows how to create a DataColumn with a new 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

Hinweise

Wenn eine DataColumn erstellt wird, hat Sie keinen ColumnName Wert.When a DataColumn is created, it has no ColumnName value. Wenn DataColumn jedoch einer DataColumnCollection für ein DataTable -Objekt hinzugefügt wird, erhält Sie einen Standardnamen ("Column1", "Column2" usw.).However, when the DataColumn is added to a DataColumnCollection for a DataTable object, it is given a default name ("Column1", "Column2", and so on).

Standardmäßig wird der Caption Wert auf den ColumnName Wert festgelegt.By default, the Caption value is set to the ColumnName value.

Gilt für:

Siehe auch