(0) exportieren Drucken
Alle erweitern

DataRelationCollection.Add-Methode (String, DataColumn[], DataColumn[])

Erstellt mit dem angegebenen Namen sowie den angegebenen Arrays der übergeordneten und untergeordneten Spalten eine DataRelation und fügt diese der Auflistung hinzu.

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

public virtual DataRelation Add (
	string name,
	DataColumn[] parentColumns,
	DataColumn[] childColumns
)
public DataRelation Add (
	String name, 
	DataColumn[] parentColumns, 
	DataColumn[] childColumns
)
public function Add (
	name : String, 
	parentColumns : DataColumn[], 
	childColumns : DataColumn[]
) : DataRelation

Parameter

name

Der Name der zu erstellenden DataRelation.

parentColumns

Ein Array von übergeordneten DataColumn-Objekten.

childColumns

Ein Array von untergeordneten DataColumn-Objekten.

Rückgabewert

Die erstellte DataRelation.

AusnahmetypBedingung

ArgumentNullException

Der Name der Beziehung ist ein NULL-Wert.

ArgumentException

Die Beziehung gehört bereits zu dieser Auflistung, oder sie gehört zu einer anderen Auflistung.

DuplicateNameException

Die Auflistung enthält bereits eine Beziehung mit demselben Namen. (Beim Vergleich wird die Groß- und Kleinschreibung nicht berücksichtigt.)

InvalidConstraintException

Die Beziehung hat einen ungültigen Zustand angenommen, nachdem sie erstellt wurde.

Wenn die Beziehung der Auflistung erfolgreich hinzugefügt wurde, tritt das CollectionChanged-Ereignis ein.

Wenn ein DataRelation-Objekt zur Auflistung hinzugefügt wird, werden standardmäßig ein ForeignKeyConstraint-Objekt und ein UniqueConstraint-Objekt erstellt, sofern die beiden Objekte nicht bereits vorhanden sind.

private void AddRelation() 
{
    DataTable table = new DataTable();
    DataColumn column1 = table.Columns.Add("Column1");
    DataColumn column2 = table.Columns.Add("Column2");
    table.ChildRelations.Add("New Relation", column1, column2);
}

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.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0
Anzeigen:
© 2014 Microsoft