Freigeben über


DataRelationCollection.Add Methode

Definition

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
Quelle:
DataRelationCollection.cs
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

Der relation-Parameter ist ein NULL-Wert.

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

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

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

Gilt für:

Add(DataColumn, DataColumn)

Quelle:
DataRelationCollection.cs
Quelle:
DataRelationCollection.cs
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

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

Gilt für:

Add(DataColumn[], DataColumn[])

Quelle:
DataRelationCollection.cs
Quelle:
DataRelationCollection.cs
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

Die erstellte Beziehung.

Ausnahmen

Das relation-Argument ist ein NULL-Wert.

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

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

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

Gilt für:

Add(String, DataColumn, DataColumn)

Quelle:
DataRelationCollection.cs
Quelle:
DataRelationCollection.cs
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);
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

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

Gilt für:

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

Quelle:
DataRelationCollection.cs
Quelle:
DataRelationCollection.cs
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);
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

Der erstellte DataRelation.

Ausnahmen

Der Name der Beziehung ist ein NULL-Wert.

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

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

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

Gilt für:

Add(String, DataColumn, DataColumn, Boolean)

Quelle:
DataRelationCollection.cs
Quelle:
DataRelationCollection.cs
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);
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

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

Gilt für:

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

Quelle:
DataRelationCollection.cs
Quelle:
DataRelationCollection.cs
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);
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

Die erstellte Beziehung.

Ausnahmen

Der Name der Beziehung ist ein NULL-Wert.

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

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

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

Gilt für: