DataColumn Klasse

Definition

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataColumn : System.ComponentModel.MarshalByValueComponent

public class DataColumn : System.ComponentModel.MarshalByValueComponent

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataColumn = class
    inherit MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Vererbung

Object

MarshalByValueComponent

DataColumn

Attribute

DynamicallyAccessedMembersAttribute

Beispiele

Im folgenden Beispiel wird ein DataTable Mit mehreren DataColumn Objekten erstellt.

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

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

    ' Create a DataColumn and set various properties. 
    Dim column As 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

Hinweise

Dies DataColumn ist der grundlegende Baustein zum Erstellen des Schemas eines DataTable. Sie erstellen das Schema, indem Sie einem oder mehreren DataColumn Objekten das DataColumnCollectionSchema hinzufügen. Weitere Informationen finden Sie unter Hinzufügen von Spalten zu einer DataTable.

Jede DataColumn verfügt über eine DataType Eigenschaft, die die Art der enthaltenen Daten DataColumn bestimmt. Sie können z. B. den Datentyp auf ganze Zahlen oder Zeichenfolgen oder Dezimalstellen beschränken. Da Daten, die in der Datenquelle enthalten sind, in der DataTable Regel wieder mit der ursprünglichen Datenquelle zusammengeführt werden, müssen Sie mit den Datentypen in der Datenquelle übereinstimmen. Weitere Informationen finden Sie unter "Datentypzuordnungen" in ADO.NET.

Eigenschaften wie AllowDBNull, Uniqueund ReadOnly setzen Einschränkungen für die Eingabe und Aktualisierung von Daten, wodurch die Datenintegrität gewährleistet wird. Sie können die automatische Datengenerierung auch mit den AutoIncrementEigenschaften AutoIncrementSeedund AutoIncrementStep Eigenschaften steuern. Weitere Informationen zu AutoIncrement Spalten finden Sie unter Erstellen von AutoIncrement-Spalten. Weitere Informationen finden Sie unter Definieren von Primärschlüsseln.

Sie können auch sicherstellen, dass Werte in einem DataColumn Eindeutigen sind, indem Sie einen UniqueConstraint Wert erstellen und dem ConstraintCollection der DataTableDataColumn Betreffenden hinzufügen. Weitere Informationen finden Sie unter DataTable Constraints.

Wenn Sie eine Beziehung zwischen DataColumn Objekten erstellen möchten, erstellen Sie ein DataRelation Objekt, und fügen Sie es dem DataRelationCollection Objekt eines Objekts DataSethinzu.

Sie können die Expression Eigenschaft des DataColumn Objekts verwenden, um die Werte in einer Spalte zu berechnen oder eine Aggregatspalte zu erstellen. Weitere Informationen finden Sie unter Erstellen von Ausdrucksspalten.

Threadsicherheit

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

Weitere Informationen

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Verwenden von DataSets in ADO.NET