DataColumn 建構函式

定義

命名空間:

System.Data

組件:

netstandard.dll, System.Data.Common.dll

初始化 DataColumn 類別的新執行個體。

多載

名稱	Description
DataColumn()	將類別的新實例 DataColumn 初始化為型別字串。
DataColumn(String)	以指定的欄位名稱初始化類別的新實例 DataColumn ，作為型別字串。
DataColumn(String, Type)	使用指定的欄位名稱和資料型態初始化該類別的新實例 DataColumn 。
DataColumn(String, Type, String)	使用指定的名稱、資料型態和表達式初始化該類別的新 DataColumn 實例。
DataColumn(String, Type, String, MappingType)	使用指定的名稱、資料型態、表達式及值初始化該類別的新實例 DataColumn ，以判斷欄位是否為屬性。

DataColumn()

來源:

DataColumn.cs

將類別的新實例 DataColumn 初始化為型別字串。

public:
 DataColumn();

public DataColumn();

Public Sub New ()

範例

以下範例會建立一個新的 DataColumn，設定各種屬性，並將其加入物件的 DataTable aDataColumnCollection。

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」等）。

另請參閱

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• 在 ADO.NET 中使用 DataSets

DataColumn(String)

來源:

DataColumn.cs

以指定的欄位名稱初始化類別的新實例 DataColumn ，作為型別字串。

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

public DataColumn(string? columnName);

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

Public Sub New (columnName As String)

參數

columnName

String

一個字串，代表要建立的欄位名稱。 若設為 null 或 為空字串（“”），則在加入欄位集合時會指定預設名稱。

範例

以下範例建立 DataColumn 一個指定為 ColumnName的新 。

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 屬性值。

另請參閱

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• 在 ADO.NET 中使用 DataSets

DataColumn(String, Type)

來源:

DataColumn.cs

使用指定的欄位名稱和資料型態初始化該類別的新實例 DataColumn 。

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)

參數

columnName

String

一個字串，代表要建立的欄位名稱。 若設為 null 或 為空字串（“”），則在加入欄位集合時會指定預設名稱。

dataType

Type

A，有支援 DataType。

例外狀況

ArgumentNullException

沒有被明確規定。dataType

範例

以下範例建立 DataColumn 一個指定且 ColumnNameDataType的新 。

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

另請參閱

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• 在 ADO.NET 中使用 DataSets

DataColumn(String, Type, String)

來源:

DataColumn.cs

使用指定的名稱、資料型態和表達式初始化該類別的新 DataColumn 實例。

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)

參數

columnName

String

一個字串，代表要建立的欄位名稱。 若設為 null 或 為空字串（“”），則在加入欄位集合時會指定預設名稱。

dataType

Type

A，有支援 DataType。

expr

String

用來建立此欄位的表達式。 如需詳細資訊，請參閱 Expression 屬性 (Property)。

屬性

RequiresUnreferencedCodeAttribute

例外狀況

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

另請參閱

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• 在 ADO.NET 中使用 DataSets

DataColumn(String, Type, String, MappingType)

來源:

DataColumn.cs

使用指定的名稱、資料型態、表達式及值初始化該類別的新實例 DataColumn ，以判斷欄位是否為屬性。

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)

參數

columnName

String

一個字串，代表要建立的欄位名稱。 若設為 null 或 為空字串（“”），則在加入欄位集合時會指定預設名稱。

dataType

Type

A，有支援 DataType。

expr

String

用來建立此欄位的表達式。 如需詳細資訊，請參閱 Expression 屬性 (Property)。

type

MappingType

這是其中一項 MappingType 價值。

屬性

RequiresUnreferencedCodeAttribute

例外狀況

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 。 該屬性規定當 a DataSet 轉換成 XML 文件時，a 是如何DataColumn映射的。 例如，若欄位名為「fName」，其值為「Bob」，且 type 設定為 MappingType.Attribute，XML 元素如下：

<姓名 fName = 「Bob」/>

欲了解更多欄位如何映射到元素或屬性的資訊，請參閱屬性。ColumnMapping

另請參閱

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• 在 ADO.NET 中使用 DataSets