DataColumn 建構函式

定義

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

多載

DataColumn()

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

DataColumn(String)

使用指定的資料行名稱,初始化 DataColumn 類別的新執行個體為類型字串。

DataColumn(String, Type)

使用指定的資料行名稱和資料類型,初始化 DataColumn 類別的新執行個體。

DataColumn(String, Type, String)

使用指定的名稱、資料型別和運算式,初始化 DataColumn 類別的新執行個體。

DataColumn(String, Type, String, MappingType)

使用指定名稱、資料型別、運算式和判斷資料行是否是屬性 (Attribute) 的值,初始化 DataColumn 類別的新執行個體。

DataColumn()

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

public:
 DataColumn();
public DataColumn ();
Public Sub New ()

範例

下列範例會建立新的 DataColumn 、設定各種屬性,並將它新增至 DataColumnCollectionDataTable 物件的 。

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 物件沒有預設 ColumnNameCaption 。 當您將它新增至 DataColumnCollection 時,如果名稱尚未指派給 ColumnName ,就會產生預設名稱 (「Column1」、「Column2」 等) 。

另請參閱

適用於

DataColumn(String)

使用指定的資料行名稱,初始化 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 類別的新執行個體。

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

例外狀況

未指定任何的 dataType

範例

下列範例會使用指定的 ColumnNameDataType 建立新的 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 類別的新執行個體。

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

例外狀況

未指定任何的 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)

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

例外狀況

未指定任何的 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 屬性。

另請參閱

適用於