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

Source:

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)

Source:

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 属性。

示例

以下示例将 添加到 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 事件。

另请参阅

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

Add(String)

Source:

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)

Source:

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)

Source:

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