DataColumn Konstruktoren

Definition

Namespace:: System.Data

Assemblys:: netstandard.dll, System.Data.Common.dll

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der DataColumn-Klasse.

Überlädt

Name	Beschreibung
DataColumn()	Initialisiert eine neue Instanz der DataColumn Klasse als Typzeichenfolge.
DataColumn(String)	Initialisiert eine neue Instanz der DataColumn Klasse als Typzeichenfolge unter Verwendung des angegebenen Spaltennamens.
DataColumn(String, Type)	Initialisiert eine neue Instanz der DataColumn Klasse mithilfe des angegebenen Spaltennamens und datentyps.
DataColumn(String, Type, String)	Initialisiert eine neue Instanz der DataColumn Klasse mit dem angegebenen Namen, Datentyp und Ausdruck.
DataColumn(String, Type, String, MappingType)	Initialisiert eine neue Instanz der DataColumn Klasse mithilfe des angegebenen Namens, des Datentyps, des 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

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Initialisiert eine neue Instanz der DataColumn Klasse als Typzeichenfolge.

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird ein neues DataColumnObjekt erstellt, verschiedene Eigenschaften festgelegt und einem DataColumnCollection Objekt DataTable hinzugefügt.

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

Wenn ein Objekt erstellt wird, hat es DataColumn keine Standard ColumnName - oder Caption. Wenn Sie ihn zu einem DataColumnCollectionHinzufügen hinzufügen, wird ein Standardname ("Spalte1", "Spalte2" usw.) generiert, wenn kein Name zugewiesen ColumnNamewurde.

Weitere Informationen

Gilt für:

DataColumn(String)

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Initialisiert eine neue Instanz der DataColumn Klasse als Typzeichenfolge 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 dieser Wert auf null eine leere Zeichenfolge ("") festgelegt ist, wird beim Hinzufügen zur Spaltenauflistung ein Standardname angegeben.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn mit einem angegebenen ColumnNameObjekt erstellt.

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 name, der für eine Spalte spezifisch ist, zum Caption Eigenschaftswert.

Weitere Informationen

Gilt für:

DataColumn(String, Type)

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Initialisiert eine neue Instanz der DataColumn Klasse mithilfe 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

dataType: Type

Eine unterstützte DataType.

Ausnahmen

ArgumentNullException

Es wurde kein dataType Wert angegeben.

Beispiele

Im folgenden Beispiel wird ein neues DataColumn mit einer angegebenen ColumnName und DataType.

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

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Initialisiert eine neue Instanz der DataColumn Klasse mit dem angegebenen Namen, Datentyp und Ausdruck.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr);

public DataColumn(string? columnName, Type dataType, string? expr);

public DataColumn(string columnName, Type dataType, string expr);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn

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

dataType: Type

Eine unterstützte DataType.

expr: String

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

Attribute: RequiresUnreferencedCodeAttribute

Ausnahmen

ArgumentNullException

Es wurde kein dataType Wert 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

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Initialisiert eine neue Instanz der DataColumn Klasse mithilfe des angegebenen Namens, des Datentyps, des 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, 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);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn

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

dataType: Type

Eine unterstützte 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.

Attribute: RequiresUnreferencedCodeAttribute

Ausnahmen

ArgumentNullException

Es wurde kein dataType Wert 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 Objekt zugeordnet wird, wenn ein DataSet XML-Dokument transformiert wird. Wenn die Spalte beispielsweise "fName" heißt und der darin enthaltene Wert "Bob" lautet und type auf MappingType.Attribute"Bob" festgelegt ist, lautet das XML-Element wie folgt:

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

DataColumn Konstruktoren

Definition

Überlädt

DataColumn()

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DataColumn(String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DataColumn(String, Type)

Parameter

Ausnahmen

Beispiele

Weitere Informationen

Gilt für:

DataColumn(String, Type, String)

Parameter

Ausnahmen

Beispiele

Weitere Informationen

Gilt für:

DataColumn(String, Type, String, MappingType)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback