DataColumn Konstruktory

Definicja

Przestrzeń nazw:

System.Data

Zestawy:

netstandard.dll, System.Data.Common.dll

Inicjuje nowe wystąpienie klasy DataColumn.

Przeciążenia

Nazwa	Opis
DataColumn()	Inicjuje DataColumn nowe wystąpienie klasy jako ciąg typu.
DataColumn(String)	Inicjuje DataColumn nowe wystąpienie klasy jako ciąg typu przy użyciu określonej nazwy kolumny.
DataColumn(String, Type)	Inicjuje nowe wystąpienie DataColumn klasy przy użyciu określonej nazwy kolumny i typu danych.
DataColumn(String, Type, String)	Inicjuje nowe wystąpienie DataColumn klasy przy użyciu określonej nazwy, typu danych i wyrażenia.
DataColumn(String, Type, String, MappingType)	Inicjuje nowe wystąpienie DataColumn klasy przy użyciu określonej nazwy, typu danych, wyrażenia i wartości, która określa, czy kolumna jest atrybutem.

DataColumn()

Źródło:

DataColumn.cs

Inicjuje DataColumn nowe wystąpienie klasy jako ciąg typu.

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Przykłady

Poniższy przykład tworzy nowy DataColumnobiekt , ustawia różne właściwości i dodaje go do DataColumnCollectionDataTable obiektu .

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

Uwagi

Podczas tworzenia obiekt nie ma wartości domyślnej DataColumnColumnName ani Caption. Po dodaniu jej do DataColumnCollectionelementu zostanie wygenerowana nazwa domyślna ("Kolumna1", "Kolumna2" itd.), jeśli nazwa nie została przypisana do .ColumnName

Zobacz też

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Używanie zestawów danych w ADO.NET

DataColumn(String)

Źródło:

DataColumn.cs

Inicjuje DataColumn nowe wystąpienie klasy jako ciąg typu przy użyciu określonej nazwy kolumny.

public:
 DataColumn(System::String ^ columnName);

public DataColumn(string? columnName);

new System.Data.DataColumn : string -> System.Data.DataColumn

Public Sub New (columnName As String)

Parametry

columnName

String

Ciąg reprezentujący nazwę kolumny do utworzenia. Jeśli zostanie ustawiona null wartość lub pusty ciąg (""), zostanie określona nazwa domyślna po dodaniu do kolekcji kolumn.

Przykłady

W poniższym przykładzie zostanie utworzony nowy DataColumn element o określonym ColumnNameobiekcie .

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

Uwagi

Domyślnie nazwa specyficzna dla kolumny staje się wartością Caption właściwości.

Zobacz też

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• Używanie zestawów danych w ADO.NET

DataColumn(String, Type)

Źródło:

DataColumn.cs

Inicjuje nowe wystąpienie DataColumn klasy przy użyciu określonej nazwy kolumny i typu danych.

public:
 DataColumn(System::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)

Parametry

columnName

String

Ciąg reprezentujący nazwę kolumny do utworzenia. Jeśli zostanie ustawiona null wartość lub pusty ciąg (""), zostanie określona nazwa domyślna po dodaniu do kolekcji kolumn.

dataType

Type

Obsługiwany element DataType.

Wyjątki

ArgumentNullException

Nie dataType określono.

Przykłady

W poniższym przykładzie zostanie utworzona nowa DataColumn z określonymi ColumnName elementami i 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

Zobacz też

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Używanie zestawów danych w ADO.NET

DataColumn(String, Type, String)

Źródło:

DataColumn.cs

Inicjuje nowe wystąpienie DataColumn klasy przy użyciu określonej nazwy, typu danych i wyrażenia.

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

[<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

Public Sub New (columnName As String, dataType As Type, expr As String)

Parametry

columnName

String

Ciąg reprezentujący nazwę kolumny do utworzenia. Jeśli zostanie ustawiona null wartość lub pusty ciąg (""), zostanie określona nazwa domyślna po dodaniu do kolekcji kolumn.

dataType

Type

Obsługiwany element DataType.

expr

String

Wyrażenie użyte do utworzenia tej kolumny. Aby uzyskać więcej informacji, zobacz właściwość Expression.

Atrybuty

RequiresUnreferencedCodeAttribute

Wyjątki

ArgumentNullException

Nie dataType określono.

Przykłady

Poniższy przykład tworzy obliczoną kolumnę.

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

Zobacz też

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• Używanie zestawów danych w ADO.NET

DataColumn(String, Type, String, MappingType)

Źródło:

DataColumn.cs

Inicjuje nowe wystąpienie DataColumn klasy przy użyciu określonej nazwy, typu danych, wyrażenia i wartości, która określa, czy kolumna jest atrybutem.

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

[<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

Public Sub New (columnName As String, dataType As Type, expr As String, type As MappingType)

Parametry

columnName

String

Ciąg reprezentujący nazwę kolumny do utworzenia. Jeśli zostanie ustawiona null wartość lub pusty ciąg (""), zostanie określona nazwa domyślna po dodaniu do kolekcji kolumn.

dataType

Type

Obsługiwany element DataType.

expr

String

Wyrażenie użyte do utworzenia tej kolumny. Aby uzyskać więcej informacji, zobacz właściwość Expression.

type

MappingType

MappingType Jedna z wartości.

Atrybuty

RequiresUnreferencedCodeAttribute

Wyjątki

ArgumentNullException

Nie dataType określono.

Przykłady

Poniższy przykład konstruuje obliczoną kolumnę.

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

Uwagi

Argument type ustawia ColumnMapping właściwość . Właściwość określa, jak DataColumn obiekt jest mapowany, gdy DataSet element jest przekształcany w dokument XML. Jeśli na przykład kolumna ma nazwę "fName", a wartość, która zawiera, to "Bob" i type jest ustawiona na MappingType.Attribute, element XML będzie następujący:

<Nazwa fName = 'Bob'/>

Aby uzyskać więcej informacji na temat sposobu mapowania kolumn na elementy lub atrybuty, zobacz ColumnMapping właściwość .

Zobacz też

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• Używanie zestawów danych w ADO.NET