DataColumnCollection.Add 方法

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

建立 DataColumn 物件，並將它加入 DataColumnCollection。

多載

Add()	建立 DataColumn 物件，並將它加入 DataColumnCollection。
Add(DataColumn)	建立指定的 DataColumn 物件，並將它加入 DataColumnCollection。
Add(String)	建立具有指定名稱的 DataColumn 物件，並將它加入 DataColumnCollection。
Add(String, Type)	建立具有指定名稱和型別的 DataColumn 物件，並將它加入 DataColumnCollection。
Add(String, Type, String)	建立具有指定名稱、型別和運算式的 DataColumn 物件，並將它加入 DataColumnCollection。

Add()

來源:

DataColumnCollection.cs

建立 DataColumn 物件，並將它加入 DataColumnCollection。

public:
 System::Data::DataColumn ^ Add();

public System.Data.DataColumn Add ();

member this.Add : unit -> System.Data.DataColumn

Public Function Add () As DataColumn

傳回

DataColumn

新建立的 DataColumn。

範例

下列範例會建立 並將新的 DataColumn 新增至 DataColumnCollection 的 DataTable。

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add()

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "Total"
       .Expression = "UnitPrice * Quantity"
       .ReadOnly = True
       .Unique = False
    End With
End Sub

備註

默認名稱 (“Column1”、“Column2”，依此類) 提供給數據行。

如果加入或移除數據行成功變更集合，就會 CollectionChanged 發生此事件。

另請參閱

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

來源:

DataColumnCollection.cs

建立指定的 DataColumn 物件，並將它加入 DataColumnCollection。

public:
 void Add(System::Data::DataColumn ^ column);

public void Add (System.Data.DataColumn column);

member this.Add : System.Data.DataColumn -> unit

Public Sub Add (column As DataColumn)

參數

column

DataColumn

要加入的 DataColumn。

例外狀況

ArgumentNullException

column 參數為 null。

ArgumentException

資料行永遠屬於這個集合，或屬於另一個集合。

DuplicateNameException

集合不具有含有指定名稱的資料行 (這項比較不會區分大小寫。)

InvalidExpressionException

運算式無效。 請參閱 Expression 屬性，取得如何建立運算式的詳細資訊。

範例

下列範例會將 新增 DataColumn 至 DataColumnCollection。

Private Sub AddDataColumn()
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    Dim column As New DataColumn()
    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "ItemPrice"
       .Caption = "Price"
       .ReadOnly = False
       .Unique = False
       .DefaultValue = 0
    End With
    columns.Add(column)
End Sub

備註

如果加入或移除數據行成功變更集合，就會 CollectionChanged 發生此事件。

另請參閱

• ColumnName
• CollectionChanged
• Contains(String)
• DataType
• Expression

Add(String)

來源:

DataColumnCollection.cs

建立具有指定名稱的 DataColumn 物件，並將它加入 DataColumnCollection。

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

public System.Data.DataColumn Add (string? columnName);

member this.Add : string -> System.Data.DataColumn

Public Function Add (columnName As String) As DataColumn

參數

columnName

String

資料行名稱。

傳回

DataColumn

新建立的 DataColumn。

例外狀況

DuplicateNameException

集合不具有含有指定名稱的資料行 (這項比較不會區分大小寫。)

範例

下列範例會建立 並將 新的 DataColumn 加入至 DataColumnCollection 的 DataTable。

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add("Total")

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ReadOnly = True
       .Expression = "UnitPrice * Quantity"
       .Unique = False
    End With
End Sub

備註

根據預設， DataType 新資料列的 是 string。

如果 null 或為名稱傳入空字串 (“”) ，則會將預設名稱 (“Column1”、“Column2” 等) 提供給數據行。

Contains使用 方法來判斷具有建議名稱的數據行是否已存在於集合中。

如果加入或移除數據行成功變更集合，就會 CollectionChanged 發生此事件。

另請參閱

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

來源:

DataColumnCollection.cs

建立具有指定名稱和型別的 DataColumn 物件，並將它加入 DataColumnCollection。

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public System.Data.DataColumn Add (string? columnName, Type type);

member this.Add : string * Type -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type) As DataColumn

參數

columnName

String

建立資料行時要使用的 ColumnName。

type

Type

新資料行的 DataType。

傳回

DataColumn

新建立的 DataColumn。

例外狀況

DuplicateNameException

集合不具有含有指定名稱的資料行 (這項比較不會區分大小寫。)

InvalidExpressionException

運算式無效。 請參閱 Expression 屬性，取得如何建立運算式的詳細資訊。

範例

下列範例會建立 並將 新的 DataColumn 加入至 DataColumnCollection 的 DataTable。

Private Sub AddColumn()
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    ' Add a new column and return it.
    Dim column As DataColumn = columns.Add( _
        "Total", System.Type.GetType("System.Decimal"))
    column.ReadOnly = True
    column.Unique = False
End Sub

備註

如果 null 或為名稱傳入空字串 (“”) ，則會將預設名稱 (“Column1”、“Column2” 等) 提供給數據行。

Contains使用 方法來判斷具有建議名稱的數據行是否已存在於集合中。

如果加入或移除數據行成功變更集合，就會 CollectionChanged 發生此事件。

另請參閱

• ColumnName
• DataType
• Expression

Add(String, Type, String)

來源:

DataColumnCollection.cs

建立具有指定名稱、型別和運算式的 DataColumn 物件，並將它加入 DataColumnCollection。

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public System.Data.DataColumn Add (string? columnName, Type type, string expression);

member this.Add : string * Type * string -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type, expression As String) As DataColumn

參數

columnName

String

建立資料行時要使用的名稱。

type

Type

新資料行的 DataType。

expression

String

要指派給 Expression 屬性的運算式。

傳回

DataColumn

新建立的 DataColumn。

例外狀況

DuplicateNameException

集合不具有含有指定名稱的資料行 (這項比較不會區分大小寫。)

InvalidExpressionException

運算式無效。 請參閱 Expression 屬性，取得如何建立運算式的詳細資訊。

範例

下列範例會建立 並將 新的 DataColumn 加入至 DataColumnCollection 的 DataTable。

Private Sub AddColumn()
    ' Get the DataColumnCollection of a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    ' Add a new column and return it.
    Dim column As DataColumn = _
        columns.Add("Total", System.Type.GetType( _
        "System.Decimal"), "Price + Tax")
    column.ReadOnly = True
    column.Unique = False
 End Sub

備註

如果 null 或為名稱傳入空字串 (“”) ，則會將預設名稱 (“Column1”、“Column2” 等) 提供給數據行。

Contains使用 方法來判斷具有建議名稱的數據行是否已存在於集合中。

如果加入或移除數據行成功變更集合，就會 CollectionChanged 發生此事件。

另請參閱

• ColumnName
• Contains(String)
• DataType
• Expression