ConstraintCollection.AddRange(Constraint[]) Methode

Definition

Kopiert die Elemente des angegebenen ConstraintCollection-Arrays an das Ende der Auflistung.

public:
 void AddRange(cli::array <System::Data::Constraint ^> ^ constraints);
public void AddRange (System.Data.Constraint[]? constraints);
public void AddRange (System.Data.Constraint[] constraints);
member this.AddRange : System.Data.Constraint[] -> unit
Public Sub AddRange (constraints As Constraint())

Parameter

constraints
Constraint[]

Ein Array von ConstraintCollection-Objekten, die der Auflistung hinzugefügt werden sollen.

Beispiele

Im folgenden Beispiel werden Primär- und Fremdschlüsseleinschränkungen erstellt und der ConstraintCollectionhinzugefügt.

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

Hinweise

Wenn BeginInit aufgerufen wurde, fügt der Auflistung erst dann Objekte hinzu, AddRange wenn EndInit aufgerufen wird. Zum Zeitpunkt EndInit des Aufrufs wird die Auflistung mit den Elementen aufgefüllt, die im letzten Aufruf von AddRangeangegeben sind. Wenn AddRange innerhalb einerEndInitBeginInit / Sequenz mehrmals aufgerufen wird, werden nur die Elemente hinzugefügt, die im letzten Aufruf von AddRange angegeben sind.

Gilt für: