DataColumn-Konstruktor (String, Type, String, MappingType)

Artikel
08/20/2007

Initialisiert eine neue Instanz der DataColumn-Klasse unter Verwendung des angegebenen Namens, Datentyps, Ausdrucks und des Werts, der bestimmt, ob es sich bei der Spalte um ein Attribut handelt.

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

Syntax

'Declaration
Public Sub New ( _
    columnName As String, _
    dataType As Type, _
    expr As String, _
    type As MappingType _
)
'Usage
Dim columnName As String
Dim dataType As Type
Dim expr As String
Dim type As MappingType

Dim instance As New DataColumn(columnName, dataType, expr, type)

public DataColumn (
    string columnName,
    Type dataType,
    string expr,
    MappingType type
)

public:
DataColumn (
    String^ columnName, 
    Type^ dataType, 
    String^ expr, 
    MappingType type
)

public DataColumn (
    String columnName, 
    Type dataType, 
    String expr, 
    MappingType type
)

public function DataColumn (
    columnName : String, 
    dataType : Type, 
    expr : String, 
    type : MappingType
)

Parameter

columnName
Eine Zeichenfolge, die den Namen der zu erstellenden Spalte darstellt. Wenn diese auf NULL (Nothing in Visual Basic) oder eine leere Zeichenfolge ("") festgelegt ist, wird beim Hinzufügen zur Spaltenauflistung ein Standardname zugewiesen.

dataType
Ein unterstützter DataType.

expr
Der Ausdruck, der zum Erstellen dieser Spalte verwendet wird. Weitere Informationen finden Sie unter der Expression-Eigenschaft.

type
Einer der MappingType-Werte.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Es wurde kein dataType angegeben.

Hinweise

Das type-Argument legt die ColumnMapping-Eigenschaft fest. Die Eigenschaft gibt an, wie eine DataColumn zugeordnet wird, wenn ein DataSet in ein XML-Dokument umgewandelt wird. Wenn z. B. der Name der Spalte "fName" lautet, der darin enthaltene Wert "Bob" und type auf MappingType.Attribute festgelegt ist, ergibt sich folgendes XML-Element:

Weitere Informationen über das Zuordnen von Spalten zu Elementen oder Attributen finden Sie unter der ColumnMapping-Eigenschaft.

Beispiel

Im folgenden Beispiel wird eine berechnete Spalte erstellt.

Private Sub CreateComputedColumn(ByVal table As DataTable)
    Dim column As DataColumn
    Dim decimalType As System.Type = _
        System.Type.GetType("System.Decimal")

    ' The expression multiplies the "Price" column value by the 
    ' "Quantity" to create the "Total" column.
    Dim expression As String = "Price * Quantity"

    ' Create the column, setting the type to Attribute.
    column = New DataColumn("Total", decimalType, _
        expression, MappingType.Attribute)

    ' Set various properties.
    column.AutoIncrement = False
    column.ReadOnly = True

    ' Add the column to a DataTable object's DataColumnCollection.
    DataSet1.Tables("OrderDetails").Columns.Add(column)
End Sub

private void CreateComputedColumn(DataTable table)
{
    System.Type myDataType = 
        System.Type.GetType("System.Decimal");

    // The expression multiplies the "Price" column value 
    // by the "Quantity" to create the "Total" column.
    string expression = "Price * Quantity";

    // Create the column, setting the type to Attribute.
    DataColumn column = new DataColumn("Total", myDataType, 
        expression, MappingType.Attribute);

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add the column to a DataTable object's to DataColumnCollection.
    DataSet1.Tables["OrderDetails"].Columns.Add(column);
}

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
ColumnMapping
Caption
DefaultValue
DataTable
DataType

Freigeben über