(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

DataColumn.ColumnName-Eigenschaft

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

Namespace:  System.Data
Assembly:  System.Data (in System.Data.dll)

public string ColumnName { get; set; }

Eigenschaftswert

Typ: System.String
Der Name der Spalte.

AusnahmeBedingung
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.

Beim Erstellen der DataColumn verfügt diese über keinen ColumnName-Wert. Wenn die DataColumn jedoch der DataColumnCollection eines DataTable-Objekts hinzugefügt wird, erhält sie einen Standardnamen ("Column1", "Column2" usw.).

Der Caption-Wert wird in der Standardeinstellung auf den ColumnName-Wert festgelegt.

Im folgenden Beispiel wird der ColumnName für sämtliche Spalten in allen Tabellen eines DataSet abgerufen. Außerdem wird veranschaulicht, wie eine DataColumn mit einem neuen ColumnName erstellt wird.


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);
}


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft