共用方式為


DataColumnCollection.Add 方法

定義

建立 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
來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs

建立 DataColumn 物件,並將它加入 DataColumnCollection

public:
 System::Data::DataColumn ^ Add();
public:
 virtual System::Data::DataColumn ^ Add();
public System.Data.DataColumn Add ();
public virtual System.Data.DataColumn Add ();
member this.Add : unit -> System.Data.DataColumn
abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn
Public Function Add () As DataColumn
Public Overridable Function Add () As DataColumn

傳回

新建立的 DataColumn

範例

下列範例會建立 並將新的 DataColumn 新增至 DataColumnCollectionDataTable

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 發生此事件。

另請參閱

適用於

Add(DataColumn)

來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs
來源:
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

例外狀況

column 參數為 null

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

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

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

範例

下列範例會將 新增 DataColumnDataColumnCollection

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 發生此事件。

另請參閱

適用於

Add(String)

來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs

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

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName);
public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);
public System.Data.DataColumn Add (string? columnName);
public System.Data.DataColumn Add (string columnName);
public virtual System.Data.DataColumn Add (string columnName);
member this.Add : string -> System.Data.DataColumn
abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn
Public Function Add (columnName As String) As DataColumn
Public Overridable Function Add (columnName As String) As DataColumn

參數

columnName
String

資料行名稱。

傳回

新建立的 DataColumn

例外狀況

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

範例

下列範例會建立 並將 新的 DataColumn 加入至 DataColumnCollectionDataTable

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 發生此事件。

另請參閱

適用於

Add(String, Type)

來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs

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

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public System.Data.DataColumn Add (string? columnName, Type type);
public System.Data.DataColumn Add (string columnName, Type type);
public virtual System.Data.DataColumn Add (string columnName, Type type);
member this.Add : string * Type -> System.Data.DataColumn
abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type) As DataColumn
Public Overridable Function Add (columnName As String, type As Type) As DataColumn

參數

columnName
String

建立資料行時要使用的 ColumnName

type
Type

新資料行的 DataType

傳回

新建立的 DataColumn

例外狀況

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

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

範例

下列範例會建立 並將 新的 DataColumn 加入至 DataColumnCollectionDataTable

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 發生此事件。

另請參閱

適用於

Add(String, Type, String)

來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs
來源:
DataColumnCollection.cs

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

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public System.Data.DataColumn Add (string? columnName, Type type, string expression);
public System.Data.DataColumn Add (string columnName, Type type, string expression);
public virtual System.Data.DataColumn Add (string columnName, Type type, string expression);
member this.Add : string * Type * string -> System.Data.DataColumn
abstract member Add : string * Type * string -> System.Data.DataColumn
override this.Add : string * Type * string -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type, expression As String) As DataColumn
Public Overridable Function Add (columnName As String, type As Type, expression As String) As DataColumn

參數

columnName
String

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

type
Type

新資料行的 DataType

expression
String

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

傳回

新建立的 DataColumn

例外狀況

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

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

範例

下列範例會建立 並將 新的 DataColumn 加入至 DataColumnCollectionDataTable

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 發生此事件。

另請參閱

適用於