DataColumn-Klasse

Artikel
08/20/2007

Stellt das Schema einer Spalte in einer DataTable dar.

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

Syntax

'Declaration
Public Class DataColumn
    Inherits MarshalByValueComponent
'Usage
Dim instance As DataColumn

public class DataColumn : MarshalByValueComponent

public ref class DataColumn : public MarshalByValueComponent

public class DataColumn extends MarshalByValueComponent

public class DataColumn extends MarshalByValueComponent

Hinweise

Die DataColumn ist der grundlegende Baustein bei der Erstellung des Schemas einer DataTable. Das Schema wird erstellt, indem der DataColumnCollection ein oder mehrere DataColumn-Objekte hinzugefügt werden. Weitere Informationen finden Sie unter Hinzufügen von Spalten zu einer Tabelle.

Jede DataColumn besitzt eine DataType-Eigenschaft, die die Art der in der DataColumn enthaltenen Daten bestimmt. Sie können den Datentyp z. B. auf ganze Zahlen, auf Zeichenfolgen oder auf Dezimalzahlen beschränken. Da Daten in der DataTable i. d. R. wieder mit der ursprünglichen Datenquelle zusammengeführt werden, müssen die Datentypen mit denen in der Datenquelle übereinstimmen. Weitere Informationen finden Sie unter Zuordnen der Datentypen von Datenanbietern zu .NET Framework-Datentypen.

Eigenschaften wie AllowDBNull, Unique und ReadOnly legen Beschränkungen für das Eingeben und Aktualisieren von Daten fest und tragen somit zur Datenintegrität bei. Sie können die automatische Datengenerierung auch mit der AutoIncrement-Eigenschaft, der AutoIncrementSeed-Eigenschaft und der AutoIncrementStep-Eigenschaft steuern. Weitere Informationen über AutoIncrement-Spalten finden Sie unter Erstellen von AutoIncrement-Spalten. Weitere Informationen finden Sie unter Definieren eines Primärschlüssels für eine Tabelle.

Sie können die Eindeutigkeit von Werten in einer DataColumn auch sicherstellen, indem Sie eine UniqueConstraint erstellen und der ConstraintCollection der DataTable hinzufügen, zu der die DataColumn gehört. Weitere Informationen finden Sie unter Hinzufügen von Einschränkungen zu einer Tabelle.

Um eine Beziehung zwischen DataColumn-Objekten herzustellen, erstellen Sie ein DataRelation-Objekt und fügen es der DataRelationCollection eines DataSet hinzu.

Mit der Expression-Eigenschaft des DataColumn-Objekts können Sie Werte in einer Spalte berechnen oder eine Aggregatspalte erstellen. Weitere Informationen finden Sie unter Erstellen von Ausdrucksspalten.

Beispiel

Im folgenden Beispiel wird eine DataTable mit mehreren DataColumn-Objekten erstellt.

Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As DataTable = new DataTable("Product") 

    ' Create a DataColumn and set various properties. 
    Dim column As DataColumn = New DataColumn 
    column.DataType = System.Type.GetType("System.Decimal") 
    column.AllowDBNull = False 
    column.Caption = "Price"  
    column.ColumnName = "Price" 
    column.DefaultValue = 25 

    ' Add the column to the table. 
    table.Columns.Add(column) 

    ' Add 10 rows and set values. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

private void MakeTable()
{ 
    // Create a DataTable. 
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties. 
    DataColumn column = new DataColumn(); 
    column.DataType = System.Type.GetType("System.Decimal"); 
    column.AllowDBNull = false; 
    column.Caption = "Price"; 
    column.ColumnName = "Price"; 
    column.DefaultValue = 25; 

    // Add the column to the table. 
    table.Columns.Add(column); 

    // Add 10 rows and set values. 
    DataRow row; 
    for(int i = 0; i < 10; i++)
    { 
        row = table.NewRow(); 
        row["Price"] = i + 1; 

        // Be sure to add the new row to the 
        // DataRowCollection. 
        table.Rows.Add(row); 
    } 
}

Vererbungshierarchie

System.Object
System.ComponentModel.MarshalByValueComponent
System.Data.DataColumn

Threadsicherheit

Dieser Typ ist bei Multithread-Lesevorgängen sicher. Sie müssen alle Schreibvorgänge synchronisieren.

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-Member
System.Data-Namespace
Add
DataColumnCollection
Constraints
ConstraintCollection-Klasse
System.Windows.Forms.DataGrid
DataRow
DataTable
DataSet
NewRow
DataRowCollection
UniqueConstraint

Freigeben über