ConstraintCollection.Add Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Constraint Menambahkan objek ke koleksi.

Overload

Add(Constraint)	Menambahkan objek yang ditentukan Constraint ke koleksi.
Add(String, DataColumn, Boolean)	Membuat baru UniqueConstraint dengan nama, DataColumn, dan nilai yang ditentukan yang menunjukkan apakah kolom tersebut adalah kunci primer, dan menambahkannya ke koleksi.
Add(String, DataColumn, DataColumn)	Membuat baru ForeignKeyConstraint dengan nama, kolom induk, dan kolom anak yang ditentukan, dan menambahkan batasan ke koleksi.
Add(String, DataColumn[], Boolean)	Membuat baru UniqueConstraint dengan nama, array DataColumn objek, dan nilai yang ditentukan yang menunjukkan apakah kolom adalah kunci primer, dan menambahkannya ke koleksi.
Add(String, DataColumn[], DataColumn[])	Membuat baru ForeignKeyConstraint, dengan array kolom induk dan kolom anak yang ditentukan, dan menambahkan batasan ke koleksi.

Add(Constraint)

Sumber:

ConstraintCollection.cs

Menambahkan objek yang ditentukan Constraint ke koleksi.

public:
 void Add(System::Data::Constraint ^ constraint);

public void Add (System.Data.Constraint constraint);

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

Public Sub Add (constraint As Constraint)

Parameter

constraint

Constraint

yang Constraint akan ditambahkan.

Pengecualian

ArgumentNullException

Argumen constraint null.

ArgumentException

Batasan sudah termasuk dalam koleksi ini, atau milik koleksi lain.

DuplicateNameException

Koleksi sudah memiliki batasan dengan nama yang sama. (Perbandingan tidak peka huruf besar/kecil.)

Contoh

Contoh berikut menambahkan UniqueConstraint ke ConstraintCollection dari DataTable.

private void AddConstraint(DataTable table)
{
    UniqueConstraint uniqueConstraint;
    // Assuming a column named "UniqueColumn" exists, and
    // its Unique property is true.
    uniqueConstraint = new UniqueConstraint(
        table.Columns["UniqueColumn"]);
    table.Constraints.Add(uniqueConstraint);
}

Private Sub AddConstraint(table As DataTable)
    Dim uniqueConstraint As UniqueConstraint
    ' Assuming a column named "UniqueColumn" exists, and 
    ' its Unique property is true.
    uniqueConstraint = _
       New UniqueConstraint(table.Columns("UniqueColumn"))
    table.Constraints.Add(uniqueConstraint)
End Sub

Keterangan

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

Lihat juga

• UniqueConstraint
• ForeignKeyConstraint

Add(String, DataColumn, Boolean)

Sumber:

ConstraintCollection.cs

Membuat baru UniqueConstraint dengan nama, DataColumn, dan nilai yang ditentukan yang menunjukkan apakah kolom tersebut adalah kunci primer, dan menambahkannya ke koleksi.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);

public System.Data.Constraint Add (string? name, System.Data.DataColumn column, bool primaryKey);

member this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint

Public Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Parameter

name

String

Nama UniqueConstraint.

column

DataColumn

yang DataColumn batasannya berlaku.

primaryKey

Boolean

Menentukan apakah kolom harus menjadi kunci utama. Jika true, kolom akan menjadi kolom kunci primer.

Mengembalikan

Constraint

UniqueConstraintBaru.

Pengecualian

ArgumentException

Batasan sudah termasuk dalam koleksi ini.

-Atau-

Batasan milik koleksi lain.

DuplicateNameException

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

Contoh

Contoh berikut menggunakan Add metode untuk membuat dan menambahkan yang baru UniqueConstraint ke ConstraintCollection.

private void AddUniqueConstraint(DataTable table){
   table.Constraints.Add("idConstraint", table.Columns["id"], true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    table.Constraints.Add("idConstraint", table.Columns("id"), True)
End Sub

Keterangan

Peristiwa CollectionChanged terjadi jika batasan berhasil ditambahkan.

Lihat juga

• UniqueConstraint

Add(String, DataColumn, DataColumn)

Sumber:

ConstraintCollection.cs

Membuat baru ForeignKeyConstraint dengan nama, kolom induk, dan kolom anak yang ditentukan, dan menambahkan batasan ke koleksi.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);

public System.Data.Constraint Add (string? name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

member this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint

Public Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Parameter

name

String

Nama ForeignKeyConstraint.

primaryKeyColumn

DataColumn

Kunci primer, atau induk, DataColumn.

foreignKeyColumn

DataColumn

Kunci asing, atau anak, DataColumn.

Mengembalikan

Constraint

ForeignKeyConstraintBaru.

Contoh

Contoh berikut menambahkan baru ForeignKeyConstraint ke ConstraintCollection dari DataTable.

private void AddForeignConstraint(DataSet dataSet)
{
    try
    {
        DataColumn parentColumn =
            dataSet.Tables["Suppliers"].Columns["SupplierID"];
        DataColumn childColumn =
            dataSet.Tables["Products"].Columns["SupplierID"];
        dataSet.Tables["Products"].Constraints.Add
            ("ProductsSuppliers", parentColumn, childColumn);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint(dataSet As DataSet)
    Try
        Dim parentColumn As DataColumn = _
            dataSet.Tables("Suppliers").Columns("SupplierID")
        Dim childColumn As DataColumn = _
            dataSet.Tables("Products").Columns("SupplierID")
        dataSet.Tables("Products").Constraints.Add _
            ("ProductsSuppliers", parentColumn, childColumn)
        
    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

Keterangan

Peristiwa CollectionChanged terjadi jika batasan berhasil ditambahkan.

Add(String, DataColumn[], Boolean)

Sumber:

ConstraintCollection.cs

Membuat baru UniqueConstraint dengan nama, array DataColumn objek, dan nilai yang ditentukan yang menunjukkan apakah kolom adalah kunci primer, dan menambahkannya ke koleksi.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);

public System.Data.Constraint Add (string? name, System.Data.DataColumn[] columns, bool primaryKey);

member this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint

Public Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Parameter

name

String

Nama UniqueConstraint.

columns

DataColumn[]

Array DataColumn objek tempat batasan diterapkan.

primaryKey

Boolean

Menentukan apakah kolom harus menjadi kunci utama. Jika true, kolom akan menjadi kolom kunci primer.

Mengembalikan

Constraint

UniqueConstraintBaru.

Pengecualian

ArgumentException

Batasan sudah termasuk dalam koleksi ini.

-Atau-

Batasan milik koleksi lain.

DuplicateNameException

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

Contoh

Contoh berikut membuat array DataColumn objek yang digunakan untuk membuat baru UniqueConstraint di tertentu DataTable.

private void AddUniqueConstraint(DataTable table)
{
    DataColumn[] columns = new DataColumn[1];
    columns[0] = table.Columns["ID"];
    columns[1] = table.Columns["Name"];
    table.Constraints.Add("idNameConstraint", columns, true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    Dim columns(1) As DataColumn
    columns(0) = table.Columns("ID")
    columns(1) = table.Columns("Name")
    table.Constraints.Add("idNameConstraint", columns, True)
End Sub

Keterangan

Peristiwa CollectionChanged terjadi jika batasan berhasil ditambahkan.

Lihat juga

• UniqueConstraint

Add(String, DataColumn[], DataColumn[])

Sumber:

ConstraintCollection.cs

Membuat baru ForeignKeyConstraint, dengan array kolom induk dan kolom anak yang ditentukan, dan menambahkan batasan ke koleksi.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public System.Data.Constraint Add (string? name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

member this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint

Public Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Parameter

name

String

Nama ForeignKeyConstraint.

primaryKeyColumns

DataColumn[]

Array DataColumn objek yang merupakan kunci primer, atau induk, kolom.

foreignKeyColumns

DataColumn[]

Array DataColumn objek yang merupakan kunci asing, atau anak, kolom.

Mengembalikan

Constraint

ForeignKeyConstraintBaru.

Contoh

Contoh berikut membuat dua array objek, lalu membuat dua ForeignKeyConstraint hubungan antara dua tabel dalam himpunan DataColumn data.

private void AddForeignConstraint(
    DataSet dataSet, DataTable table)
{
    try
    {
        DataColumn[] parentColumns = new DataColumn[2];
        DataColumn[] childColumns = new DataColumn[2];
        // Get the tables from the DataSet.
        DataTable customersTable = dataSet.Tables["Customers"];
        DataTable ordersTable = dataSet.Tables["Orders"];

        // Set Columns.
        parentColumns[0]=customersTable.Columns["id"];
        parentColumns[1]=customersTable.Columns["Name"];
        childColumns[0] = ordersTable.Columns["CustomerID"];
        childColumns[1] = ordersTable.Columns["CustomerName"];

        // Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint",
            parentColumns, childColumns);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint( _
ByVal dataSet As DataSet, ByVal table As DataTable)
    Try
        Dim parentColumns(1) As DataColumn
        Dim childColumns(1) As DataColumn
        ' Get the tables from the DataSet.
        Dim customersTable As DataTable = _
            dataSet.Tables("Customers")
        Dim ordersTable As DataTable = _
            dataSet.Tables("Orders")

        ' Set Columns.
        parentColumns(0) = customersTable.Columns("id")
        parentColumns(1) = customersTable.Columns("Name")
        childColumns(0) = ordersTable.Columns("CustomerID")
        childColumns(1) = ordersTable.Columns("CustomerName")

        ' Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint", _
            parentColumns, childColumns)

    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

Keterangan

Peristiwa CollectionChanged terjadi jika batasan berhasil ditambahkan.