DataRelationCollection.Add Methode

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Gilt für:

Freigeben über

DataRelationCollection.Add Methode

Definition

Überlädt

Add(DataRelation)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Add(DataColumn, DataColumn)

Parameter

Gibt zurück

Hinweise

Weitere Informationen

Gilt für:

Add(DataColumn[], DataColumn[])

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Add(String, DataColumn, DataColumn)

Parameter

Gibt zurück

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(String, DataColumn, DataColumn, Boolean)

Parameter

Gibt zurück

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen