DataRelationCollection.AddRange-Methode

Artikel
08/20/2007

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

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overridable Sub AddRange ( _
    relations As DataRelation() _
)
'Usage
Dim instance As DataRelationCollection
Dim relations As DataRelation()

instance.AddRange(relations)

public virtual void AddRange (
    DataRelation[] relations
)

public:
virtual void AddRange (
    array<DataRelation^>^ relations
)

public void AddRange (
    DataRelation[] relations
)

public function AddRange (
    relations : DataRelation[]
)

Parameter

relations
Das Array von DataRelation-Objekten, das der Auflistung hinzugefügt werden soll.

Hinweise

Wenn BeginInit aufgerufen wurde, fügt AddRange der Auflistung bis zu einem Aufruf von EndInit keine Objekte hinzu. Zum Zeitpunkt des Aufrufs von EndInit wird die Auflistung mit den Elementen gefüllt, die beim letzten Aufruf von AddRange angegeben wurden. Wenn AddRange mehrmals in einer BeginInit/EndInit-Sequenz aufgerufen wird, werden nur die Elemente hinzugefügt, die beim letzten Aufruf von AddRange angegeben wurden.

Beispiel

Public Shared Sub AddRelations(dataSet As DataSet)
    Dim customerOrders As DataRelation = _
        New DataRelation("CustomerOrders", _
        dataSet.Tables("Customers").Columns("customerId"), _
        dataSet.Tables("Orders").Columns("customerId"))
    Dim orderDetails As DataRelation = _
        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

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());
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataRelationCollection-Klasse
DataRelationCollection-Member
System.Data-Namespace

Weitere Ressourcen

Hinzufügen einer Beziehung zwischen Tabellen
Navigieren in einer Beziehung zwischen Tabellen

Freigeben über