ConstraintCollection.AddRange(Constraint[]) Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

ConstraintCollection.cs

Copia os elementos da matriz ConstraintCollection especificada para o fim da coleção.

public:
 void AddRange(cli::array <System::Data::Constraint ^> ^ constraints);

public void AddRange (System.Data.Constraint[]? constraints);

member this.AddRange : System.Data.Constraint[] -> unit

Public Sub AddRange (constraints As Constraint())

Parâmetros

constraints

Constraint[]

Uma matriz de objetos ConstraintCollection a serem adicionados à coleção.

Exemplos

O exemplo a seguir cria restrições de chave primária e estrangeira e as adiciona ao ConstraintCollection.

public static void ConstraintAddRange(DataSet dataSet)
{
    try
    {
        // Reference the tables from the DataSet.
        DataTable customersTable = dataSet.Tables["Customers"];
        DataTable ordersTable = dataSet.Tables["Orders"];

        // Create unique and foreign key constraints.
        UniqueConstraint uniqueConstraint = new
            UniqueConstraint(customersTable.Columns["CustomerID"]);
        ForeignKeyConstraint fkConstraint = new
            ForeignKeyConstraint("CustOrdersConstraint",
            customersTable.Columns["CustomerID"],
            ordersTable.Columns["CustomerID"]);

        // Add the constraints.
        customersTable.Constraints.AddRange(new Constraint[]
            {uniqueConstraint, fkConstraint});
    }
    catch(Exception ex)
    {
        // Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Public Shared Sub ConstraintAddRange(dataSet As DataSet)
    Try
        ' Reference the tables from the DataSet.
        Dim customersTable As DataTable = dataSet.Tables("Customers")
        Dim ordersTable As DataTable = dataSet.Tables("Orders")

        ' Create unique and foreign key constraints.
        Dim uniqueConstraint As New UniqueConstraint( _
            customersTable.Columns("CustomerID"))
        Dim fkConstraint As New ForeignKeyConstraint("CustOrdersConstraint", _
            customersTable.Columns("CustomerID"), _
            ordersTable.Columns("CustomerID"))

        ' Add the constraints.
        customersTable.Constraints.AddRange(New Constraint() _
            {uniqueConstraint, fkConstraint})

    Catch ex As Exception
        ' Process exception and return.
        Console.WriteLine($"Exception of type {ex.GetType()} occurred.")
    End Try
End Sub

Comentários

Se BeginInit tiver sido chamado, AddRange não adicionará nenhum objeto à coleção até EndInit que seja chamado. No momento em que EndInit for chamado, a coleção será preenchida com os itens especificados na chamada mais recente para AddRange. Se AddRange for chamado várias vezes em umaEndInitBeginInit / sequência, somente os itens especificados na chamada mais recente a AddRange serão adicionados.