DataRelationCollection.Add Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Fügt der DataRelation einen DataRelationCollection hinzu.

Überlädt

Add(DataRelation)	Fügt der DataRelation einen DataRelationCollection hinzu.
Add(DataColumn, DataColumn)	Erstellt eine DataRelation mit der angegebenen übergeordneten und untergeordneten Spalte und fügt sie der Auflistung hinzu.
Add(DataColumn[], DataColumn[])	Erstellt eine DataRelation mit den angegebenen übergeordneten und untergeordneten Spalten und fügt sie der Auflistung hinzu.
Add(String, DataColumn, DataColumn)	Erstellt eine DataRelation mit dem angegebenen Namen und den angegebenen übergeordneten und untergeordneten Spalten und fügt sie der Auflistung hinzu.
Add(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.
Add(String, DataColumn, DataColumn, Boolean)	Erstellt eine DataRelation mit dem angegebenen Namen, übergeordneten und untergeordneten Spalten mit optionalen Beschränkungen entsprechend dem Wert des createConstraints-Parameters und fügt diese der Auflistung hinzu.
Add(String, DataColumn[], DataColumn[], Boolean)	Erstellt mit dem angegebenen Namen, den angegebenen Arrays der übergeordneten und untergeordneten Spalten sowie dem Wert, der angibt, ob eine Einschränkung erstellt werden soll, eine DataRelation und fügt diese der Auflistung hinzu.

Add(DataRelation)

Quelle:

DataRelationCollection.cs

Fügt der DataRelation einen DataRelationCollection hinzu.

public:
 void Add(System::Data::DataRelation ^ relation);

public void Add (System.Data.DataRelation relation);

member this.Add : System.Data.DataRelation -> unit

Public Sub Add (relation As DataRelation)

Parameter

relation

DataRelation

Der der Auflistung hinzuzufügende DataRelation.

Ausnahmen

ArgumentNullException

Der relation-Parameter 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 dem angegebenen Namen. (Beim Vergleich wird die Groß- und Kleinschreibung nicht berücksichtigt.)

InvalidConstraintException

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

Hinweise

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

Wenn der Auflistung ein DataRelation -Objekt hinzugefügt wird und UniqueConstraint Objekte standardmäßig erstellt werden, ForeignKeyConstraint wenn sie noch nicht vorhanden sind.

Weitere Informationen

• Hinzufügen von "DataRelations"
• Navigieren in "DataRelations"

Add(DataColumn, DataColumn)

Quelle:

DataRelationCollection.cs

Erstellt eine DataRelation mit der angegebenen übergeordneten und untergeordneten Spalte und fügt sie der Auflistung hinzu.

public:
 virtual System::Data::DataRelation ^ Add(System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);

public virtual System.Data.DataRelation Add (System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

abstract member Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation

Public Overridable Function Add (parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

Parameter

parentColumn

DataColumn

Die übergeordnete Spalte in der Beziehung.

childColumn

DataColumn

Die untergeordnete Spalte in der Beziehung.

Gibt zurück

DataRelation

Die erstellte Beziehung.

Hinweise

Wenn der Auflistung ein DataRelation -Objekt hinzugefügt wird und UniqueConstraint Objekte standardmäßig erstellt werden, ForeignKeyConstraint wenn sie noch nicht vorhanden sind.

Weitere Informationen

• Hinzufügen von "DataRelations"
• Navigieren in "DataRelations"

Add(DataColumn[], DataColumn[])

Quelle:

DataRelationCollection.cs

Erstellt eine DataRelation mit den angegebenen übergeordneten und untergeordneten Spalten und fügt sie der Auflistung hinzu.

public:
 virtual System::Data::DataRelation ^ Add(cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);

public virtual System.Data.DataRelation Add (System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

abstract member Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation

Public Overridable Function Add (parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

Parameter

parentColumns

DataColumn[]

Die übergeordneten Spalten in der Beziehung.

childColumns

DataColumn[]

Die untergeordneten Spalten in der Beziehung.

Gibt zurück

DataRelation

Die erstellte Beziehung.

Ausnahmen

ArgumentNullException

Das relation-Argument 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.

Hinweise

Wenn der Auflistung ein DataRelation -Objekt hinzugefügt wird und UniqueConstraint Objekte standardmäßig erstellt werden, ForeignKeyConstraint wenn sie noch nicht vorhanden sind.

Weitere Informationen

• Hinzufügen von "DataRelations"
• Navigieren in "DataRelations"

Add(String, DataColumn, DataColumn)

Quelle:

DataRelationCollection.cs

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

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

Parameter

name

String

Der Name der Beziehung.

parentColumn

DataColumn

Die übergeordnete Spalte in der Beziehung.

childColumn

DataColumn

Die untergeordnete Spalte in der Beziehung.

Gibt zurück

DataRelation

Die erstellte Beziehung.

Hinweise

Wenn der Auflistung ein DataRelation -Objekt hinzugefügt wird und UniqueConstraint Objekte standardmäßig erstellt werden, ForeignKeyConstraint wenn sie noch nicht vorhanden sind.

Weitere Informationen

• Hinzufügen von "DataRelations"
• Navigieren in "DataRelations"

Add(String, DataColumn[], DataColumn[])

Quelle:

DataRelationCollection.cs

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

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

Parameter

name

String

Der Name der zu erstellenden DataRelation.

parentColumns

DataColumn[]

Ein Array von übergeordneten DataColumn-Objekten.

childColumns

DataColumn[]

Ein Array von untergeordneten DataColumn-Objekten.

Gibt zurück

DataRelation

Der erstellte DataRelation.

Ausnahmen

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.

Beispiele

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

Private Sub AddRelation()
    Dim table As New DataTable()
    Dim column1 As DataColumn = table.Columns.Add("Column1")
    Dim column2 As DataColumn = table.Columns.Add("Column2")
    table.ChildRelations.Add("New Relation", column1, column2)
End Sub

Hinweise

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

Wenn der Auflistung ein DataRelation -Objekt hinzugefügt wird und UniqueConstraint Objekte standardmäßig erstellt werden, ForeignKeyConstraint wenn sie noch nicht vorhanden sind.

Weitere Informationen

• Hinzufügen von "DataRelations"
• Navigieren in "DataRelations"

Add(String, DataColumn, DataColumn, Boolean)

Quelle:

DataRelationCollection.cs

Erstellt eine DataRelation mit dem angegebenen Namen, übergeordneten und untergeordneten Spalten mit optionalen Beschränkungen entsprechend dem Wert des createConstraints-Parameters und fügt diese der Auflistung hinzu.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);

abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean) As DataRelation

Parameter

name

String

Der Name der Beziehung.

parentColumn

DataColumn

Die übergeordnete Spalte in der Beziehung.

childColumn

DataColumn

Die untergeordnete Spalte in der Beziehung.

createConstraints

Boolean

true, wenn Einschränkungen erstellt werden sollen, andernfalls false. (Der Standardwert ist true).

Gibt zurück

DataRelation

Die erstellte Beziehung.

Hinweise

Wenn der Auflistung ein DataRelation -Objekt hinzugefügt wird und UniqueConstraint Objekte standardmäßig erstellt werden, ForeignKeyConstraint wenn sie noch nicht vorhanden sind. Um dies zu verhindern, können Sie auf false festlegen createConstraints .

Weitere Informationen

• Hinzufügen von "DataRelations"
• Navigieren in "DataRelations"

Add(String, DataColumn[], DataColumn[], Boolean)

Quelle:

DataRelationCollection.cs

Erstellt mit dem angegebenen Namen, den angegebenen Arrays der übergeordneten und untergeordneten Spalten sowie dem Wert, der angibt, ob eine Einschränkung erstellt werden soll, eine DataRelation und fügt diese der Auflistung hinzu.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);

abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean) As DataRelation

Parameter

name

String

Der Name der zu erstellenden DataRelation.

parentColumns

DataColumn[]

Ein Array von übergeordneten DataColumn-Objekten.

childColumns

DataColumn[]

Ein Array von untergeordneten DataColumn-Objekten.

createConstraints

Boolean

true, wenn eine Einschränkung erstellt werden soll, andernfalls false.

Gibt zurück

DataRelation

Die erstellte Beziehung.

Ausnahmen

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.

Hinweise

Wenn der Auflistung ein DataRelation -Objekt hinzugefügt wird und UniqueConstraint Objekte standardmäßig erstellt werden, ForeignKeyConstraint wenn sie noch nicht vorhanden sind.

Weitere Informationen

• Hinzufügen von "DataRelations"
• Navigieren in "DataRelations"