DataRelationCollection.Add Methode

Definition

Namespace:: System.Data

Assemblys:: netstandard.dll, System.Data.Common.dll

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 ein DataRelation zu dem DataRelationCollection hinzu.

Überlädt

Name	Beschreibung
Add(DataRelation)	Fügt ein DataRelation zu dem DataRelationCollection hinzu.
Add(DataColumn, DataColumn)	Erstellt eine DataRelation mit einer 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, übergeordneten und untergeordneten Spalten und fügt sie der Auflistung hinzu.
Add(String, DataColumn[], DataColumn[])	Erstellt eine DataRelation mit dem angegebenen Namen und Arrays von übergeordneten und untergeordneten Spalten und fügt sie der Auflistung hinzu.
Add(String, DataColumn, DataColumn, Boolean)	Erstellt eine DataRelation mit dem angegebenen Namen, den übergeordneten und untergeordneten Spalten, mit optionalen Einschränkungen gemäß dem Wert des `createConstraints`-Parameters und fügt sie der Auflistung hinzu.
Add(String, DataColumn[], DataColumn[], Boolean)	Erstellt eine DataRelation mit dem angegebenen Namen, Arrays von übergeordneten und untergeordneten Spalten und Wert, der angibt, ob eine Einschränkung erstellt werden soll, und fügt sie der Auflistung hinzu.

Add(DataRelation)

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Fügt ein DataRelation zu dem 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

Das DataRelation , das der Auflistung hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

Der relation Parameter ist ein Nullwert.

ArgumentException

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

DuplicateNameException

Die Auflistung weist bereits eine Beziehung mit dem angegebenen Namen auf. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

InvalidConstraintException

Die Beziehung hat seit der Erstellung einen ungültigen Zustand eingegeben.

Hinweise

Wenn die Beziehung erfolgreich der Auflistung hinzugefügt wird, tritt das CollectionChanged Ereignis auf.

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

Weitere Informationen

Gilt für:

Add(DataColumn, DataColumn)

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Erstellt eine DataRelation mit einer 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 der Beziehung.

childColumn: DataColumn

Die untergeordnete Spalte der Beziehung.

Gibt zurück

DataRelation

Die erstellte Beziehung.

Hinweise

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

Weitere Informationen

Gilt für:

Add(DataColumn[], DataColumn[])

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

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 der Beziehung.

childColumns: DataColumn[]

Die untergeordneten Spalten der Beziehung.

Gibt zurück

DataRelation

Die erstellte Beziehung.

Ausnahmen

ArgumentException

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

DuplicateNameException

Die Auflistung weist bereits eine Beziehung mit demselben Namen auf. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

InvalidConstraintException

Die Beziehung hat seit der Erstellung einen ungültigen Zustand eingegeben.

Hinweise

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

Weitere Informationen

Gilt für:

Add(String, DataColumn, DataColumn)

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Erstellt eine DataRelation mit dem angegebenen Namen, ü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 der Beziehung.

childColumn: DataColumn

Die untergeordnete Spalte der Beziehung.

Gibt zurück

DataRelation

Die erstellte Beziehung.

Hinweise

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

Weitere Informationen

Gilt für:

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

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Erstellt eine DataRelation mit dem angegebenen Namen und Arrays von übergeordneten und untergeordneten Spalten und fügt sie 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 des zu erstellenden Vorgangs DataRelation .

parentColumns: DataColumn[]

Ein Array von übergeordneten DataColumn Objekten.

childColumns: DataColumn[]

Ein Array untergeordneter DataColumn Objekte.

Gibt zurück

DataRelation

Die erstellte DataRelation.

Ausnahmen

ArgumentNullException

Der Beziehungsname ist ein Nullwert.

ArgumentException

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

DuplicateNameException

Die Auflistung weist bereits eine Beziehung mit demselben Namen auf. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

InvalidConstraintException

Die Beziehung hat seit der Erstellung einen ungültigen Zustand eingegeben.

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 der Auflistung hinzugefügt wird, tritt das CollectionChanged Ereignis auf.

Wenn der Auflistung ein DataRelation Objekt hinzugefügt wird und ForeignKeyConstraint Objekte standardmäßig erstellt werden, UniqueConstraint 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

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Erstellt eine DataRelation mit dem angegebenen Namen, den übergeordneten und untergeordneten Spalten, mit optionalen Einschränkungen gemäß dem Wert des createConstraints-Parameters und fügt sie 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 der Beziehung.

childColumn: DataColumn

Die untergeordnete Spalte der Beziehung.

createConstraints: Boolean

true um Einschränkungen zu schaffen; andernfalls false. (Der Standardwert ist true).

Gibt zurück

DataRelation

Die erstellte Beziehung.

Hinweise

Wenn der Auflistung ein DataRelation Objekt hinzugefügt wird und ForeignKeyConstraint Objekte standardmäßig erstellt werden, UniqueConstraint 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

Quelle:: DataRelationCollection.cs

Quelle:: DataRelationCollection.cs

Erstellt eine DataRelation mit dem angegebenen Namen, Arrays von übergeordneten und untergeordneten Spalten und Wert, der angibt, ob eine Einschränkung erstellt werden soll, und fügt sie 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 des zu erstellenden Vorgangs DataRelation .

parentColumns: DataColumn[]

Ein Array von übergeordneten DataColumn Objekten.

childColumns: DataColumn[]

Ein Array untergeordneter DataColumn Objekte.

createConstraints: Boolean

true eine Einschränkung zu schaffen; andernfalls false.

Gibt zurück

DataRelation

Die erstellte Beziehung.

Ausnahmen

ArgumentNullException

Der Beziehungsname ist ein Nullwert.

ArgumentException

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

DuplicateNameException

Die Auflistung weist bereits eine Beziehung mit demselben Namen auf. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

InvalidConstraintException

Die Beziehung hat seit der Erstellung einen ungültigen Zustand eingegeben.

Hinweise

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?