DataColumn Oluşturucular

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

DataColumn sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Name	Description
DataColumn()	Sınıfının yeni bir örneğini DataColumn tür dizesi olarak başlatır.
DataColumn(String)	Belirtilen sütun adını kullanarak tür dizesi olarak sınıfının yeni bir örneğini DataColumn başlatır.
DataColumn(String, Type)	Belirtilen sütun adını ve veri türünü kullanarak sınıfın yeni bir örneğini DataColumn başlatır.
DataColumn(String, Type, String)	Belirtilen adı, veri türünü ve ifadeyi DataColumn kullanarak sınıfın yeni bir örneğini başlatır.
DataColumn(String, Type, String, MappingType)	Belirtilen adı, veri türünü, ifadeyi DataColumn ve sütunun bir öznitelik olup olmadığını belirleyen değeri kullanarak sınıfın yeni bir örneğini başlatır.

DataColumn()

Kaynak:

DataColumn.cs

Sınıfının yeni bir örneğini DataColumn tür dizesi olarak başlatır.

public:
 DataColumn();

public DataColumn();

Public Sub New ()

Örnekler

Aşağıdaki örnek yeni DataColumnbir oluşturur, çeşitli özellikleri ayarlar ve nesnesi için DataTable öğesine DataColumnCollection ekler.

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

Açıklamalar

Oluşturulduğunda, bir DataColumn nesnenin varsayılan ColumnName veya Captiondeğeri yoktur. bir öğesine DataColumnCollectioneklediğinizde, öğesine bir ad atanmamışsa ColumnNamevarsayılan bir ad ("Sütun1", "Sütun2" vb.) oluşturulur.

Ayrıca bkz.

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• ADO.NET'da DataSet'leri kullanma

DataColumn(String)

Kaynak:

DataColumn.cs

Belirtilen sütun adını kullanarak tür dizesi olarak sınıfının yeni bir örneğini DataColumn başlatır.

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

public DataColumn(string? columnName);

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

Public Sub New (columnName As String)

Parametreler

columnName

String

Oluşturulacak sütunun adını temsil eden dize. veya boş bir dize ("") olarak ayarlanırsa null , sütunlar koleksiyonuna eklendiğinde varsayılan bir ad belirtilir.

Örnekler

Aşağıdaki örnek, belirtilen ColumnNameile yeni DataColumn bir oluşturur.

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

Açıklamalar

Varsayılan olarak, bir sütuna özgü ad özellik değeri olur Caption .

Ayrıca bkz.

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• ADO.NET'da DataSet'leri kullanma

DataColumn(String, Type)

Kaynak:

DataColumn.cs

Belirtilen sütun adını ve veri türünü kullanarak sınıfın yeni bir örneğini DataColumn başlatır.

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)

Parametreler

columnName

String

Oluşturulacak sütunun adını temsil eden dize. veya boş bir dize ("") olarak ayarlanırsa null , sütunlar koleksiyonuna eklendiğinde varsayılan bir ad belirtilir.

dataType

Type

Desteklenen DataTypebir .

Özel durumlar

ArgumentNullException

Belirtilmemiş dataType .

Örnekler

Aşağıdaki örnek, belirtilen ColumnName ve DataTypeile yeni DataColumn bir oluşturur.

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

Ayrıca bkz.

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• ADO.NET'da DataSet'leri kullanma

DataColumn(String, Type, String)

Kaynak:

DataColumn.cs

Belirtilen adı, veri türünü ve ifadeyi DataColumn kullanarak sınıfın yeni bir örneğini başlatır.

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)

Parametreler

columnName

String

Oluşturulacak sütunun adını temsil eden dize. veya boş bir dize ("") olarak ayarlanırsa null , sütunlar koleksiyonuna eklendiğinde varsayılan bir ad belirtilir.

dataType

Type

Desteklenen DataTypebir .

expr

String

Bu sütunu oluşturmak için kullanılan ifade. Daha fazla bilgi için Expression özelliğine bakın.

Öznitelikler

RequiresUnreferencedCodeAttribute

Özel durumlar

ArgumentNullException

Belirtilmemiş dataType .

Örnekler

Aşağıdaki örnek hesaplanan bir sütun oluşturur.

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

Ayrıca bkz.

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• ADO.NET'da DataSet'leri kullanma

DataColumn(String, Type, String, MappingType)

Kaynak:

DataColumn.cs

Belirtilen adı, veri türünü, ifadeyi DataColumn ve sütunun bir öznitelik olup olmadığını belirleyen değeri kullanarak sınıfın yeni bir örneğini başlatır.

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)

Parametreler

columnName

String

Oluşturulacak sütunun adını temsil eden dize. veya boş bir dize ("") olarak ayarlanırsa null , sütunlar koleksiyonuna eklendiğinde varsayılan bir ad belirtilir.

dataType

Type

Desteklenen DataTypebir .

expr

String

Bu sütunu oluşturmak için kullanılan ifade. Daha fazla bilgi için Expression özelliğine bakın.

type

MappingType

Değerlerden MappingType biri.

Öznitelikler

RequiresUnreferencedCodeAttribute

Özel durumlar

ArgumentNullException

Belirtilmemiş dataType .

Örnekler

Aşağıdaki örnek hesaplanan bir sütun oluşturur.

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

Açıklamalar

type bağımsız değişkeni özelliğini ayarlarColumnMapping. özelliği, bir DataColumn XML belgesine dönüştürüldüğünde a'nın DataSet nasıl eşlendiğini belirtir. Örneğin, sütun "fName" olarak adlandırılırsa ve içerdiği değer "Bob" ise ve type olarak MappingType.Attributeayarlanırsa, XML öğesi aşağıdaki gibi olur:

<Ad fName = 'Bob'/>

Sütunların öğelere veya özniteliklere nasıl eşlendiği hakkında daha fazla bilgi için özelliğine ColumnMapping bakın.

Ayrıca bkz.

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• ADO.NET'da DataSet'leri kullanma