Freigeben über


DataColumn Konstruktoren

Definition

Initialisiert eine neue Instanz der DataColumn-Klasse.

Überlädt

DataColumn()

Initialisiert eine neue instance der DataColumn -Klasse als Typzeichenfolge.

DataColumn(String)

Initialisiert eine neue Instanz der DataColumn-Klasse als type-Zeichenfolge und unter Verwendung des angegebenen Spaltennamens.

DataColumn(String, Type)

Initialisiert eine neue Instanz der DataColumn-Klasse unter Verwendung des angegebenen Spaltennamens und Datentyps.

DataColumn(String, Type, String)

Initialisiert eine neue Instanz der DataColumn-Klasse unter Verwendung des angegebenen Namens, Datentyps und Ausdrucks.

DataColumn(String, Type, String, MappingType)

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.

DataColumn()

Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs

Initialisiert eine neue instance der DataColumn -Klasse als Typzeichenfolge.

public:
 DataColumn();
public DataColumn ();
Public Sub New ()

Beispiele

Im folgenden Beispiel wird eine neue DataColumnerstellt, legt verschiedene Eigenschaften fest und fügt sie einem DataColumnCollection für das DataTable -Objekt hinzu.

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn();

    // Set various properties.
    column.ColumnName = "id";
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As New DataColumn()

    ' Set various properties.
    With column
       .ColumnName = "id"
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Hinweise

Bei der Erstellung weist ein DataColumn Objekt keinen Standardwert ColumnName oder auf Caption. Wenn Sie es einem DataColumnCollectionhinzufügen, wird ein Standardname ("Column1", "Column2" usw.) generiert, wenn dem ColumnNamekein Name zugewiesen wurde.

Weitere Informationen

Gilt für:

DataColumn(String)

Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs

Initialisiert eine neue Instanz der DataColumn-Klasse als type-Zeichenfolge und unter Verwendung des angegebenen Spaltennamens.

public:
 DataColumn(System::String ^ columnName);
public DataColumn (string? columnName);
public DataColumn (string columnName);
new System.Data.DataColumn : string -> System.Data.DataColumn
Public Sub New (columnName As String)

Parameter

columnName
String

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

Beispiele

Im folgenden Beispiel wird eine neue DataColumn mit einem angegebenen ColumnNameerstellt.

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn("id");

    // Set various properties.
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    column = New DataColumn("id")

    ' Set various properties.
    With column
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

Hinweise

Standardmäßig wird der für eine Spalte spezifische Name zum Caption Eigenschaftswert.

Weitere Informationen

Gilt für:

DataColumn(String, Type)

Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs

Initialisiert eine neue Instanz der DataColumn-Klasse unter Verwendung des angegebenen Spaltennamens und Datentyps.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType);
public DataColumn (string? columnName, Type dataType);
public DataColumn (string columnName, Type dataType);
new System.Data.DataColumn : string * Type -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type)

Parameter

columnName
String

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

dataType
Type

Ein unterstützter DataType.

Ausnahmen

Es wurde kein dataType angegeben.

Beispiele

Im folgenden Beispiel wird eine neue DataColumn mit einem angegebenen ColumnName und DataTypeerstellt.

private void AddDataColumn(DataTable table)
{
    System.Type typeInt32 =
        System.Type.GetType("System.Int32");
    DataColumn column = new DataColumn("id", typeInt32);

    // Set various properties.
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    
   Dim typeInt32 As System.Type = _
      System.Type.GetType("System.Int32")
   Dim column As DataColumn = _
       New DataColumn("id", typeInt32)

   ' Set various properties.
   With column
      .AutoIncrement = True
      .AutoIncrementSeed = 1
      .AutoIncrementStep = 1
      .ReadOnly = True
    End With

   ' Add to Columns collection.
   table.Columns.Add(column)
End Sub

Weitere Informationen

Gilt für:

DataColumn(String, Type, String)

Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs

Initialisiert eine neue Instanz der DataColumn-Klasse unter Verwendung des angegebenen Namens, Datentyps und Ausdrucks.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);
public DataColumn (string? columnName, Type dataType, string? expr);
public DataColumn (string columnName, Type dataType, string expr);
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type, expr As String)

Parameter

columnName
String

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

dataType
Type

Ein unterstützter DataType.

expr
String

Der Ausdruck, der zum Erstellen dieser Spalte verwendet wird. Weitere Informationen finden Sie in den Ausführungen zur Expression-Eigenschaft.

Ausnahmen

Es wurde kein dataType angegeben.

Beispiele

Im folgenden Beispiel wird eine berechnete Spalte erstellt.

private void AddDataColumn(DataTable table)
{
    System.Type decimalType;
    decimalType = System.Type.GetType("System.Decimal");

    // Create the column. The name is 'Tax,' with data type Decimal,and
    // an expression ('UnitPrice * .0862) to calculate the tax.
    DataColumn column = new DataColumn("Tax",
        decimalType, "UnitPrice * .0862");

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

    // Add to Columns collection.;
    table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    Dim decimalType As System.Type
 
    decimalType = System.Type.GetType("System.Decimal")
    column = New DataColumn("Tax", decimalType, "UnitPrice * .0862")

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

    ' Add to Columns collection.
    table.Columns.Add(column)
 End Sub

Weitere Informationen

Gilt für:

DataColumn(String, Type, String, MappingType)

Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs

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.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);
public DataColumn (string? columnName, Type dataType, string? expr, System.Data.MappingType type);
public DataColumn (string columnName, Type dataType, string expr, System.Data.MappingType type);
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type, expr As String, type As MappingType)

Parameter

columnName
String

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

dataType
Type

Ein unterstützter DataType.

expr
String

Der Ausdruck, der zum Erstellen dieser Spalte verwendet wird. Weitere Informationen finden Sie in den Ausführungen zur Expression-Eigenschaft.

type
MappingType

Einer der MappingType-Werte.

Ausnahmen

Es wurde kein dataType angegeben.

Beispiele

Im folgenden Beispiel wird eine berechnete Spalte erstellt.

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

Hinweise

Das type Argument legt die ColumnMapping -Eigenschaft fest. Die -Eigenschaft gibt an, wie ein DataColumn zugeordnet wird, wenn ein DataSet in ein XML-Dokument transformiert wird. Wenn die Spalte beispielsweise "fName" heißt und der darin enthaltene Wert "Bob" ist und type auf MappingType.Attributefestgelegt ist, lautet das XML-Element wie folgt:

<Name fName = 'Bob'/>

Weitere Informationen dazu, wie Spalten Elementen oder Attributen zugeordnet werden, finden Sie in der ColumnMapping -Eigenschaft.

Weitere Informationen

Gilt für: