DataColumn.Caption-Eigenschaft

Ruft die Beschriftung für die Spalte ab, oder legt diese fest.

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

Syntax

'Declaration
Public Property Caption As String
'Usage
Dim instance As DataColumn
Dim value As String

value = instance.Caption

instance.Caption = value

public string Caption { get; set; }

public:
property String^ Caption {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Caption ()

/** @property */
public void set_Caption (String value)

public function get Caption () : String

public function set Caption (value : String)

Eigenschaftenwert

Die Beschriftung der Spalte. Wenn nicht festgelegt, wird der ColumnName-Wert zurückgegeben.

Hinweise

Mit der Caption-Eigenschaft können Sie einen beschreibenden bzw. angezeigten Namen für eine DataColumn anzeigen.

Beispiel

Im folgenden Beispiel wird eine neue DataTable erstellt. Danach werden drei DataColumn-Objekte einer DataColumnCollection hinzugefügt und die Caption-Eigenschaft für jede DataColumn festgelegt.

Private Sub CreateDataTable()
    Dim table As DataTable
    Dim column As DataColumn 

    table = new DataTable("Customers")

    'CustomerID column
    column = table.Columns.Add( _
        "CustomerID", System.Type.GetType("System.Int32"))
    column.Unique = True
    
    'CustomerName column
    column = table.Columns.Add( _
        "CustomerName", System.Type.GetType("System.String"))
    column.Caption = "Name"

    'CreditLimit
    column = table.Columns.Add( _
        "CreditLimit", System.Type.GetType("System.Double"))
    column.DefaultValue = 0
    column.Caption = "Limit"

    table.Rows.Add(new object() {1, "Jonathan", 23.44})
    table.Rows.Add(new object() {2, "Bill", 56.87})
End Sub

private void CreateDataTable()
{
   DataTable table;
   DataColumn column;

   table = new DataTable("Customers");

   //CustomerID column
   column = table.Columns.Add("CustomerID", 
       System.Type.GetType("System.Int32"));
   column.Unique = true;
    
   //CustomerName column
   column = table.Columns.Add("CustomerName", 
       System.Type.GetType("System.String"));
   column.Caption = "Name";

   //CreditLimit
   column = table.Columns.Add("CreditLimit", 
       System.Type.GetType("System.Double"));
   column.DefaultValue = 0;
   column.Caption = "Limit";

   table.Rows.Add(new object[] {1, "Jonathan", 23.44});
   table.Rows.Add(new object[] {2, "Bill", 56.87});
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataColumn-Klasse
DataColumn-Member
System.Data-Namespace
ColumnName