DataRelationCollection.AddRange(DataRelation[]) Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataRelationCollection.cs

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

public:
 virtual void AddRange(cli::array <System::Data::DataRelation ^> ^ relations);

public virtual void AddRange (System.Data.DataRelation[]? relations);

abstract member AddRange : System.Data.DataRelation[] -> unit
override this.AddRange : System.Data.DataRelation[] -> unit

Public Overridable Sub AddRange (relations As DataRelation())

Parâmetros

relations

DataRelation[]

A matriz de objetos DataRelation a serem adicionados à coleção.

Exemplos

public static void AddRelations(DataSet dataSet)
{
    DataRelation customerOrders =
        new DataRelation("CustomerOrders",
        dataSet.Tables["Customers"].Columns["customerId"],
        dataSet.Tables["Orders"].Columns["customerId"]);

    DataRelation orderDetails =
        new DataRelation("OrderDetail",
        dataSet.Tables["Orders"].Columns["orderId"],
        dataSet.Tables["OrderDetails"].Columns["orderId"]);

    dataSet.Relations.AddRange(new DataRelation[]
        {customerOrders, orderDetails});

    // Display names of all relations.
    foreach (DataRelation relation in dataSet.Relations)
        Console.WriteLine(relation.RelationName.ToString());
}

Public Shared Sub AddRelations(dataSet As DataSet)
    Dim customerOrders As New DataRelation("CustomerOrders", _
        dataSet.Tables("Customers").Columns("customerId"), _
        dataSet.Tables("Orders").Columns("customerId"))
    Dim orderDetails As New DataRelation("OrderDetail", _
        dataSet.Tables("Orders").Columns("orderId"), _
        dataSet.Tables("OrderDetails").Columns("orderId"))

    dataSet.Relations.AddRange(New DataRelation() _
        {customerOrders, orderDetails})

    ' Display names of all relations.
    Dim relation As DataRelation
    For Each relation In dataSet.Relations
        Console.WriteLine(relation.RelationName.ToString())
    Next
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 dentro de umaEndInitBeginInit / sequência, somente os itens especificados na chamada mais recente para AddRange serão adicionados.

Confira também

• Adicionando DataRelations
• Navegando em DataRelations