DataColumnCollection.Add 方法

定義

命名空間:: System.Data

組件:: netstandard.dll, System.Data.Common.dll

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

建立並加入 DataColumn 一個物件到 DataColumnCollection。

多載

名稱	Description
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

來源:: 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的。

範例

以下範例為 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)

來源:: DataColumnCollection.cs

來源:: DataColumnCollection.cs

來源:: 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 一點要補充。

例外狀況

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)

來源:: DataColumnCollection.cs

來源:: DataColumnCollection.cs

來源:: 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的。

例外狀況

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

備註

預設情況下，新欄位的為 DataTypestring。

若 null 或傳入空字串（“”）作為名稱，則該欄位會被賦予預設名稱（「Column1」、「Column2」等）。

使用此 Contains 方法判斷該名稱的欄位是否已存在於該集合中。

如果集合成功新增或移除欄位，事件 CollectionChanged 就會發生。

另請參閱

適用於

Add(String, Type)

來源:: DataColumnCollection.cs

來源:: DataColumnCollection.cs

來源:: 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

新創造 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)

來源:: DataColumnCollection.cs

來源:: DataColumnCollection.cs

來源:: 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);

[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 就會發生。

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？