DataColumnCollection.Add 方法

定义

命名空间:: System.Data

程序集:: netstandard.dll, System.Data.Common.dll

程序集:: System.Data.Common.dll

程序集:: System.Data.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

创建对象并将其添加到 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

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: 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的。

示例

以下示例创建并添加新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 事件。

另请参阅

适用于

Add(DataColumn)

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

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有关如何创建表达式的详细信息，请参阅该属性。

示例

下面的示例向 a 添加一个 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 事件。

另请参阅

适用于

Add(String)

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: 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的。

例外

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 事件。

另请参阅

适用于

Add(String, Type)

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: 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

新建 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 事件。

另请参阅

适用于

Add(String, Type, String)

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: DataColumnCollection.cs

Source:: 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")]
public System.Data.DataColumn Add(string? columnName, Type type, 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);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members might be trimmed for some data types or expressions.")>]
member this.Add : string * Type * string -> System.Data.DataColumn

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

新建 DataColumn的。

属性: RequiresUnreferencedCodeAttribute

例外

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 事件。

另请参阅

适用于

反馈

此页面是否有帮助？

DataColumnCollection.Add 方法

定义

重载

Add()

返回

示例

注解

另请参阅

适用于

Add(DataColumn)

参数

例外

示例

注解

另请参阅

适用于

Add(String)

参数

返回

例外

示例

注解

另请参阅

适用于

Add(String, Type)

参数

返回

例外

示例

注解

另请参阅

适用于

Add(String, Type, String)

参数

返回

例外

示例

注解

另请参阅

适用于