DataColumn 构造函数

参考

定义

命名空间:: System.Data

程序集:: System.Data.Common.dll

程序集:: System.Data.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化 DataColumn 类的新实例。

重载

DataColumn()	将类的新实例 DataColumn 初始化为类型字符串。
DataColumn(String)	使用指定的列名称将 DataColumn 类的新实例初始化为类型字符串。
DataColumn(String, Type)	使用指定列名称和数据类型初始化 DataColumn 类的新实例。
DataColumn(String, Type, String)	使用指定的名称、数据类型和表达式初始化 DataColumn 类的新实例。
DataColumn(String, Type, String, MappingType)	使用指定名称、数据类型、表达式和确定列是否为特性的值，初始化 DataColumn 类的新实例。

DataColumn()

Source:: DataColumn.cs

Source:: DataColumn.cs

Source:: DataColumn.cs

将类的新实例 DataColumn 初始化为类型字符串。

public:
 DataColumn();

public DataColumn ();

Public Sub New ()

示例

以下示例创建一个新的 DataColumn，设置各种属性，并将其添加到对象的。DataColumnCollection DataTable

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

注解

创建后， DataColumn 对象没有默认值 ColumnName 或 Caption。将其添加到时， DataColumnCollection如果名称尚未分配给 ColumnName，则将生成默认名称 (“Column1”、“Column2”等) 。

另请参阅

适用于

DataColumn(String)

Source:: DataColumn.cs

Source:: DataColumn.cs

Source:: DataColumn.cs

使用指定的列名称将 DataColumn 类的新实例初始化为类型字符串。

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)

参数

columnName: String

一个字符串，它表示要创建的列的名称。如果设置为 null 或空字符串 ("")，则当添加到列集合中时，将指定一个默认名称。

示例

以下示例使用指定的 ColumnName创建新的 DataColumn 。

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

注解

默认情况下，特定于列的名称将成为 Caption 属性值。

另请参阅

适用于

DataColumn(String, Type)

Source:: DataColumn.cs

Source:: DataColumn.cs

Source:: DataColumn.cs

使用指定列名称和数据类型初始化 DataColumn 类的新实例。

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)

参数

columnName: String

一个字符串，它表示要创建的列的名称。如果设置为 null 或空字符串 ("")，则当添加到列集合中时，将指定一个默认名称。

dataType: Type

支持的 DataType。

例外

ArgumentNullException

未指定任何 dataType。

示例

以下示例使用指定的 ColumnName 和 DataType创建新的 DataColumn 。

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

另请参阅

适用于

DataColumn(String, Type, String)

Source:: DataColumn.cs

Source:: DataColumn.cs

Source:: DataColumn.cs

使用指定的名称、数据类型和表达式初始化 DataColumn 类的新实例。

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)

参数

columnName: String

一个字符串，它表示要创建的列的名称。如果设置为 null 或空字符串 ("")，则当添加到列集合中时，将指定一个默认名称。

dataType: Type

支持的 DataType。

expr: String

用于创建该列的表达式。有关更多信息，请参见 Expression 属性。

例外

ArgumentNullException

未指定任何 dataType。

示例

以下示例创建一个计算列。

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

另请参阅

适用于

DataColumn(String, Type, String, MappingType)

Source:: DataColumn.cs

Source:: DataColumn.cs

Source:: DataColumn.cs

使用指定名称、数据类型、表达式和确定列是否为特性的值，初始化 DataColumn 类的新实例。

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)

参数

columnName: String

一个字符串，它表示要创建的列的名称。如果设置为 null 或空字符串 ("")，则当添加到列集合中时，将指定一个默认名称。

dataType: Type

支持的 DataType。

expr: String

用于创建该列的表达式。有关更多信息，请参见 Expression 属性。

type: MappingType

MappingType 值之一。

例外

ArgumentNullException

未指定任何 dataType。

示例

以下示例构造计算列。

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

注解

参数 type 设置 ColumnMapping 属性。属性指定在转换为 XML 文档时DataSet如何DataColumn映射。例如，如果该列名为“fName”，并且它包含的值为“Bob”，并且 type 设置为 MappingType.Attribute，则 XML 元素将如下所示：

有关如何将列映射到元素或属性的详细信息，请参阅 ColumnMapping 属性。

另请参阅

适用于

通过

DataColumn 构造函数

定义

重载

DataColumn()

示例

注解

另请参阅

适用于

DataColumn(String)

参数

示例

注解

另请参阅

适用于

DataColumn(String, Type)

参数

例外

示例

另请参阅

适用于

DataColumn(String, Type, String)

参数

例外

示例

另请参阅

适用于

DataColumn(String, Type, String, MappingType)

参数

例外

示例

注解

另请参阅

适用于

其他资源