Udostępnij za pośrednictwem


ConstraintCollection.Add Metoda

Definicja

Constraint Dodaje obiekt do kolekcji.

Przeciążenia

Add(Constraint)

Dodaje określony Constraint obiekt do kolekcji.

Add(String, DataColumn, Boolean)

Tworzy nową UniqueConstraint o określonej nazwie, i wartości, która wskazuje, DataColumnczy kolumna jest kluczem podstawowym, i dodaje ją do kolekcji.

Add(String, DataColumn, DataColumn)

Tworzy nową ForeignKeyConstraint z określoną nazwą, kolumną nadrzędną i kolumną podrzędną oraz dodaje ograniczenie do kolekcji.

Add(String, DataColumn[], Boolean)

Tworzy nową UniqueConstraint z określoną nazwą, tablicą DataColumn obiektów i wartością wskazującą, czy kolumna jest kluczem podstawowym, i dodaje ją do kolekcji.

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

Tworzy nowy ForeignKeyConstraintelement z określonymi tablicami kolumn nadrzędnych i kolumn podrzędnych oraz dodaje ograniczenie do kolekcji.

Add(Constraint)

Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs

Dodaje określony Constraint obiekt do kolekcji.

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)

Parametry

constraint
Constraint

Element do dodania Constraint .

Wyjątki

Argument constraint ma wartość null.

Ograniczenie należy już do tej kolekcji lub należy do innej kolekcji.

Kolekcja ma już ograniczenie o tej samej nazwie. (W porównaniu nie jest uwzględniana wielkość liter).

Przykłady

Poniższy przykład dodaje element UniqueConstraint do obiektu ConstraintCollectionDataTabletypu .

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

Uwagi

Jeśli kolekcja zostanie pomyślnie zmieniona przez dodanie lub usunięcie ograniczeń, CollectionChanged wystąpi zdarzenie.

Zobacz też

Dotyczy

Add(String, DataColumn, Boolean)

Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs

Tworzy nową UniqueConstraint o określonej nazwie, i wartości, która wskazuje, DataColumnczy kolumna jest kluczem podstawowym, i dodaje ją do kolekcji.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);
public:
 virtual 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);
public System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);
public virtual System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);
member this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
abstract member Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
Public Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint
Public Overridable Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Parametry

name
String

Nazwa elementu UniqueConstraint.

column
DataColumn

Parametr DataColumn , do którego ma zastosowanie ograniczenie.

primaryKey
Boolean

Określa, czy kolumna powinna być kluczem podstawowym. Jeśli truekolumna będzie kolumną klucza podstawowego.

Zwraca

UniqueConstraintNowy element .

Wyjątki

Ograniczenie należy już do tej kolekcji.

— Lub —

Ograniczenie należy do innej kolekcji.

Kolekcja ma już ograniczenie o określonej nazwie. (W porównaniu nie jest uwzględniana wielkość liter).

Przykłady

W poniższym przykładzie użyto Add metody do utworzenia i dodania nowego UniqueConstraint elementu do klasy 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

Uwagi

Zdarzenie CollectionChanged występuje, jeśli ograniczenie zostało pomyślnie dodane.

Zobacz też

Dotyczy

Add(String, DataColumn, DataColumn)

Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs

Tworzy nową ForeignKeyConstraint z określoną nazwą, kolumną nadrzędną i kolumną podrzędną oraz dodaje ograniczenie do kolekcji.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);
public:
 virtual 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);
public System.Data.Constraint Add (string name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);
public virtual 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
abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint
override 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
Public Overridable Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Parametry

name
String

Nazwa elementu ForeignKeyConstraint.

primaryKeyColumn
DataColumn

Klucz podstawowy lub element nadrzędny. DataColumn

foreignKeyColumn
DataColumn

Klucz obcy lub element podrzędny. DataColumn

Zwraca

ForeignKeyConstraintNowy element .

Przykłady

Poniższy przykład dodaje nowy ForeignKeyConstraint element do ConstraintCollection obiektu 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

Uwagi

Zdarzenie CollectionChanged występuje, jeśli ograniczenie zostało pomyślnie dodane.

Dotyczy

Add(String, DataColumn[], Boolean)

Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs

Tworzy nową UniqueConstraint z określoną nazwą, tablicą DataColumn obiektów i wartością wskazującą, czy kolumna jest kluczem podstawowym, i dodaje ją do kolekcji.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);
public:
 virtual 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);
public System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);
public virtual System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);
member this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
abstract member Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
Public Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint
Public Overridable Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Parametry

name
String

Nazwa elementu UniqueConstraint.

columns
DataColumn[]

Tablica DataColumn obiektów, do których ma zastosowanie ograniczenie.

primaryKey
Boolean

Określa, czy kolumna powinna być kluczem podstawowym. Jeśli truekolumna będzie kolumną klucza podstawowego.

Zwraca

UniqueConstraintNowy element .

Wyjątki

Ograniczenie należy już do tej kolekcji.

— Lub —

Ograniczenie należy do innej kolekcji.

Kolekcja ma już ograniczenie o określonej nazwie. (W porównaniu nie jest uwzględniana wielkość liter).

Przykłady

Poniższy przykład tworzy tablicę DataColumn obiektów, które są używane do tworzenia nowego UniqueConstraint w określonym DataTableobiekcie .

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

Uwagi

Zdarzenie CollectionChanged występuje, jeśli ograniczenie zostało pomyślnie dodane.

Zobacz też

Dotyczy

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

Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs
Źródło:
ConstraintCollection.cs

Tworzy nowy ForeignKeyConstraintelement z określonymi tablicami kolumn nadrzędnych i kolumn podrzędnych oraz dodaje ograniczenie do kolekcji.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);
public:
 virtual 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);
public System.Data.Constraint Add (string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);
public virtual 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
abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint
override 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
Public Overridable Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Parametry

name
String

Nazwa elementu ForeignKeyConstraint.

primaryKeyColumns
DataColumn[]

Tablica DataColumn obiektów, które są kluczem podstawowym lub kolumnami nadrzędnymi.

foreignKeyColumns
DataColumn[]

Tablica DataColumn obiektów, które są kluczem obcym lub kolumnami podrzędnymi.

Zwraca

ForeignKeyConstraintNowy element .

Przykłady

Poniższy przykład tworzy dwie tablice DataColumn obiektów, a następnie tworzy dwie ForeignKeyConstraint relacje między dwiema tabelami w zestawie danych.

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

Uwagi

Zdarzenie CollectionChanged występuje, jeśli ograniczenie zostało pomyślnie dodane.

Dotyczy