DataColumnCollection.Add Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Membuat dan menambahkan DataColumn objek ke DataColumnCollection.

Overload

Add()	Membuat dan menambahkan DataColumn objek ke DataColumnCollection.
Add(DataColumn)	Membuat dan menambahkan objek yang ditentukan DataColumn ke DataColumnCollection.
Add(String)	Membuat dan menambahkan DataColumn objek yang memiliki nama yang ditentukan ke DataColumnCollection.
Add(String, Type)	Membuat dan menambahkan DataColumn objek yang memiliki nama dan jenis yang ditentukan ke DataColumnCollection.
Add(String, Type, String)	Membuat dan menambahkan DataColumn objek yang memiliki nama, jenis, dan ekspresi yang ditentukan ke DataColumnCollection.

Add()

Sumber:

DataColumnCollection.cs

Membuat dan menambahkan DataColumn objek ke DataColumnCollection.

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

public System.Data.DataColumn Add ();

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

Public Function Add () As DataColumn

Mengembalikan

DataColumn

Yang baru dibuat DataColumn.

Contoh

Contoh berikut membuat dan menambahkan yang baru DataColumn ke DataColumnCollection dari 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

Keterangan

Nama default ("Column1", "Column2", dan sebagainya) diberikan ke kolom.

Jika koleksi berhasil diubah dengan menambahkan atau menghapus kolom, peristiwa akan CollectionChanged terjadi.

Lihat juga

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

Sumber:

DataColumnCollection.cs

Membuat dan menambahkan objek yang ditentukan DataColumn ke 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)

Parameter

column

DataColumn

yang DataColumn akan ditambahkan.

Pengecualian

ArgumentNullException

Parameternya column adalah null.

ArgumentException

Kolom sudah menjadi milik koleksi ini, atau ke koleksi lain.

DuplicateNameException

Koleksi sudah memiliki kolom dengan nama yang ditentukan. (Perbandingannya tidak peka huruf besar/kecil.)

InvalidExpressionException

Ekspresi tidak valid. Expression Lihat properti untuk informasi selengkapnya tentang cara membuat ekspresi.

Contoh

Contoh berikut menambahkan DataColumn ke 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

Keterangan

Jika koleksi berhasil diubah dengan menambahkan atau menghapus kolom, peristiwa akan CollectionChanged terjadi.

Lihat juga

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

Add(String)

Sumber:

DataColumnCollection.cs

Membuat dan menambahkan DataColumn objek yang memiliki nama yang ditentukan ke 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

Parameter

columnName

String

Nama kolom.

Mengembalikan

DataColumn

Yang baru dibuat DataColumn.

Pengecualian

DuplicateNameException

Koleksi sudah memiliki kolom dengan nama yang ditentukan. (Perbandingannya tidak peka huruf besar/kecil.)

Contoh

Contoh berikut membuat dan menambahkan yang baru DataColumn ke DataColumnCollection dari 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

Keterangan

Secara default, DataType untuk kolom baru adalah string.

Jika null atau string kosong ("") diteruskan untuk nama tersebut, nama default ("Column1", "Column2", dan sebagainya) diberikan ke kolom.

Contains Gunakan metode untuk menentukan apakah kolom dengan nama yang diusulkan sudah ada dalam koleksi.

Jika koleksi berhasil diubah dengan menambahkan atau menghapus kolom, peristiwa akan CollectionChanged terjadi.

Lihat juga

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

Sumber:

DataColumnCollection.cs

Membuat dan menambahkan DataColumn objek yang memiliki nama dan jenis yang ditentukan ke 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

Parameter

columnName

String

untuk ColumnName digunakan saat Anda membuat kolom.

type

Type

Kolom DataType baru.

Mengembalikan

DataColumn

Yang baru dibuat DataColumn.

Pengecualian

DuplicateNameException

Koleksi sudah memiliki kolom dengan nama yang ditentukan. (Perbandingannya tidak peka huruf besar/kecil.)

InvalidExpressionException

Ekspresi tidak valid. Expression Lihat properti untuk informasi selengkapnya tentang cara membuat ekspresi.

Contoh

Contoh berikut membuat dan menambahkan yang baru DataColumn ke DataColumnCollection dari 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

Keterangan

Jika null atau string kosong ("") diteruskan untuk nama tersebut, nama default ("Column1", "Column2", dan sebagainya) diberikan ke kolom.

Contains Gunakan metode untuk menentukan apakah kolom dengan nama yang diusulkan sudah ada dalam koleksi.

Jika koleksi berhasil diubah dengan menambahkan atau menghapus kolom, peristiwa akan CollectionChanged terjadi.

Lihat juga

• ColumnName
• DataType
• Expression

Add(String, Type, String)

Sumber:

DataColumnCollection.cs

Membuat dan menambahkan DataColumn objek yang memiliki nama, jenis, dan ekspresi yang ditentukan ke 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

Parameter

columnName

String

Nama yang akan digunakan saat Anda membuat kolom.

type

Type

Kolom DataType baru.

expression

String

Ekspresi yang akan ditetapkan ke Expression properti .

Mengembalikan

DataColumn

Yang baru dibuat DataColumn.

Pengecualian

DuplicateNameException

Koleksi sudah memiliki kolom dengan nama yang ditentukan. (Perbandingannya tidak peka huruf besar/kecil.)

InvalidExpressionException

Ekspresi tidak valid. Expression Lihat properti untuk informasi selengkapnya tentang cara membuat ekspresi.

Contoh

Contoh berikut membuat dan menambahkan yang baru DataColumn ke DataColumnCollection dari 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

Keterangan

Jika null atau string kosong ("") diteruskan untuk nama tersebut, nama default ("Column1", "Column2", dan sebagainya) diberikan ke kolom.

Contains Gunakan metode untuk menentukan apakah kolom dengan nama yang diusulkan sudah ada dalam koleksi.

Jika koleksi berhasil diubah dengan menambahkan atau menghapus kolom, peristiwa akan CollectionChanged terjadi.

Lihat juga

• ColumnName
• Contains(String)
• DataType
• Expression