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)	使用指定名稱、資料型別、運算式和判斷資料行是否是屬性 (Attribute) 的值，初始化 DataColumn 類別的新執行個體。

DataColumn()

來源:: DataColumn.cs

來源:: DataColumn.cs

來源:: 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)

來源:: DataColumn.cs

來源:: DataColumn.cs

來源:: 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)

來源:: DataColumn.cs

來源:: DataColumn.cs

來源:: 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)

來源:: DataColumn.cs

來源:: DataColumn.cs

來源:: 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 屬性 (Property)。

例外狀況

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)

來源:: DataColumn.cs

來源:: DataColumn.cs

來源:: DataColumn.cs

使用指定名稱、資料型別、運算式和判斷資料行是否是屬性 (Attribute) 的值，初始化 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 屬性 (Property)。

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 檔案時，如何 DataColumn 對應 DataSet 。例如，如果數據行名為「fName」，且其包含的值是「Bob」，而且 type 設定為 MappingType.Attribute，則 XML 元素會如下所示：

<名稱 fName = 'Bob'/>

如需數據行如何對應至專案或屬性的詳細資訊，請參閱 ColumnMapping 屬性。

另請參閱

適用於

共用方式為

DataColumn 建構函式

定義

多載

DataColumn()

範例

備註

另請參閱

適用於

DataColumn(String)

參數

範例

備註

另請參閱

適用於

DataColumn(String, Type)

參數

例外狀況

範例

另請參閱

適用於

DataColumn(String, Type, String)

參數

例外狀況

範例

另請參閱

適用於

DataColumn(String, Type, String, MappingType)

參數

例外狀況

範例

備註

另請參閱

適用於

其他資源