ConstraintCollection.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 Auflistung ein Constraint-Objekt hinzu.

Überlädt

Add(Constraint)	Fügt der Auflistung das angegebene Constraint-Objekt hinzu.
Add(String, DataColumn, Boolean)	Erstellt eine neue UniqueConstraint mit dem angegebenen Namen der DataColumn sowie einem Wert, der angibt, ob die Spalte eine Primärschlüsselspalte ist, und fügt diese der Auflistung hinzu.
Add(String, DataColumn, DataColumn)	Erstellt eine neue ForeignKeyConstraint mit dem angegebenen Namen, der angegebenen übergeordneten Spalte sowie der angegebenen untergeordneten Spalte und fügt der Auflistung die Einschränkung hinzu.
Add(String, DataColumn[], Boolean)	Erstellt eine neue UniqueConstraint mit dem angegebenen Namen, einem Array von DataColumn-Objekten sowie einem Wert, der angibt, ob die Spalte eine Primärschlüsselspalte ist, und fügt diese der Auflistung hinzu.
Add(String, DataColumn[], DataColumn[])	Erstellt eine neue ForeignKeyConstraint mit den angegebenen Arrays von übergeordneten und untergeordneten Spalten und fügt die Einschränkung der Auflistung hinzu.

Add(Constraint)

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Fügt der Auflistung das angegebene Constraint-Objekt hinzu.

public:
 void Add(System::Data::Constraint ^ constraint);

public void Add (System.Data.Constraint constraint);

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

Public Sub Add (constraint As Constraint)

Parameter

constraint: Constraint

Das hinzuzufügende Constraint.

Ausnahmen

ArgumentNullException

Das constraint-Argument ist null.

ArgumentException

Die Einschränkung gehört bereits zu dieser oder einer anderen Sammlung.

DuplicateNameException

Die Sammlung enthält bereits eine Einschränkung gleichen Namens. (Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.)

Beispiele

Im folgenden Beispiel wird der UniqueConstraint ConstraintCollection eines DataTablehinzugefügt.

private void AddConstraint(DataTable table)
{
    UniqueConstraint uniqueConstraint;
    // Assuming a column named "UniqueColumn" exists, and
    // its Unique property is true.
    uniqueConstraint = new UniqueConstraint(
        table.Columns["UniqueColumn"]);
    table.Constraints.Add(uniqueConstraint);
}

Private Sub AddConstraint(table As DataTable)
    Dim uniqueConstraint As UniqueConstraint
    ' Assuming a column named "UniqueColumn" exists, and 
    ' its Unique property is true.
    uniqueConstraint = _
       New UniqueConstraint(table.Columns("UniqueColumn"))
    table.Constraints.Add(uniqueConstraint)
End Sub

Hinweise

Wenn die Auflistung durch Hinzufügen oder Entfernen von Einschränkungen erfolgreich geändert wurde, tritt das CollectionChanged -Ereignis auf.

Weitere Informationen

Gilt für:

Add(String, DataColumn, Boolean)

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Erstellt eine neue UniqueConstraint mit dem angegebenen Namen der DataColumn sowie einem Wert, der angibt, ob die Spalte eine Primärschlüsselspalte ist, und fügt diese der Auflistung hinzu.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);

public System.Data.Constraint Add (string? name, System.Data.DataColumn column, bool primaryKey);

public System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);

public virtual System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);

member this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint

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

Public Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Public Overridable Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Parameter

name: String

Der Name von UniqueConstraint.

column: DataColumn

Die DataColumn, auf die die Einschränkung angewendet wird.

primaryKey: Boolean

Gibt an, ob die Spalte der Primärschlüssel sein sollte. Wenn true, dann ist die Spalte eine Primärschlüsselspalte.

Gibt zurück

Constraint

Ein neuer UniqueConstraint.

Ausnahmen

ArgumentException

Die Einschränkung gehört bereits zu dieser Auflistung.

-Oder-

Die Einschränkung gehört zu einer anderen Auflistung.

DuplicateNameException

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

Beispiele

Im folgenden Beispiel wird die Add -Methode verwendet, um eine neue UniqueConstraint zu erstellen und zu ConstraintCollectionhinzuzufügen.

private void AddUniqueConstraint(DataTable table){
   table.Constraints.Add("idConstraint", table.Columns["id"], true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    table.Constraints.Add("idConstraint", table.Columns("id"), True)
End Sub

Hinweise

Das CollectionChanged Ereignis tritt auf, wenn die Einschränkung erfolgreich hinzugefügt wurde.

Weitere Informationen

UniqueConstraint

Gilt für:

Add(String, DataColumn, DataColumn)

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Erstellt eine neue ForeignKeyConstraint mit dem angegebenen Namen, der angegebenen übergeordneten Spalte sowie der angegebenen untergeordneten Spalte und fügt der Auflistung die Einschränkung hinzu.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);

public System.Data.Constraint Add (string? name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

public System.Data.Constraint Add (string name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

public virtual System.Data.Constraint Add (string name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

member this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint

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

Public Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Public Overridable Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Parameter

name: String

Der Name von ForeignKeyConstraint.

primaryKeyColumn: DataColumn

Die übergeordnete oder Primärschlüssel, DataColumn.

foreignKeyColumn: DataColumn

Der untergeordnete oder Fremdschlüssel, DataColumn.

Gibt zurück

Constraint

Ein neuer ForeignKeyConstraint.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstraint zu einer ConstraintCollection DataTablehinzugefügt.

private void AddForeignConstraint(DataSet dataSet)
{
    try
    {
        DataColumn parentColumn =
            dataSet.Tables["Suppliers"].Columns["SupplierID"];
        DataColumn childColumn =
            dataSet.Tables["Products"].Columns["SupplierID"];
        dataSet.Tables["Products"].Constraints.Add
            ("ProductsSuppliers", parentColumn, childColumn);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint(dataSet As DataSet)
    Try
        Dim parentColumn As DataColumn = _
            dataSet.Tables("Suppliers").Columns("SupplierID")
        Dim childColumn As DataColumn = _
            dataSet.Tables("Products").Columns("SupplierID")
        dataSet.Tables("Products").Constraints.Add _
            ("ProductsSuppliers", parentColumn, childColumn)
        
    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

Hinweise

Das CollectionChanged Ereignis tritt auf, wenn die Einschränkung erfolgreich hinzugefügt wurde.

Gilt für:

Add(String, DataColumn[], Boolean)

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Erstellt eine neue UniqueConstraint mit dem angegebenen Namen, einem Array von DataColumn-Objekten sowie einem Wert, der angibt, ob die Spalte eine Primärschlüsselspalte ist, und fügt diese der Auflistung hinzu.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);

public System.Data.Constraint Add (string? name, System.Data.DataColumn[] columns, bool primaryKey);

public System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);

public virtual System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);

member this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint

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

Public Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Public Overridable Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Parameter

name: String

Der Name von UniqueConstraint.

columns: DataColumn[]

Ein Array von DataColumn-Objekten, auf die die Einschränkung angewendet wird.

primaryKey: Boolean

Gibt an, ob die Spalte der Primärschlüssel sein sollte. Wenn true, dann ist die Spalte eine Primärschlüsselspalte.

Gibt zurück

Constraint

Ein neuer UniqueConstraint.

Ausnahmen

ArgumentException

Die Einschränkung gehört bereits zu dieser Auflistung.

-Oder-

Die Einschränkung gehört zu einer anderen Auflistung.

DuplicateNameException

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

Beispiele

Im folgenden Beispiel wird ein Array von DataColumn -Objekten erstellt, die zum Erstellen einer neuen UniqueConstraint in einer bestimmten DataTableverwendet werden.

private void AddUniqueConstraint(DataTable table)
{
    DataColumn[] columns = new DataColumn[1];
    columns[0] = table.Columns["ID"];
    columns[1] = table.Columns["Name"];
    table.Constraints.Add("idNameConstraint", columns, true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    Dim columns(1) As DataColumn
    columns(0) = table.Columns("ID")
    columns(1) = table.Columns("Name")
    table.Constraints.Add("idNameConstraint", columns, True)
End Sub

Hinweise

Das CollectionChanged Ereignis tritt auf, wenn die Einschränkung erfolgreich hinzugefügt wurde.

Weitere Informationen

UniqueConstraint

Gilt für:

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

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Erstellt eine neue ForeignKeyConstraint mit den angegebenen Arrays von übergeordneten und untergeordneten Spalten und fügt die Einschränkung der Auflistung hinzu.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public System.Data.Constraint Add (string? name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

public System.Data.Constraint Add (string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

public virtual System.Data.Constraint Add (string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

member this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint

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

Public Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Public Overridable Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Parameter

name: String

Der Name von ForeignKeyConstraint.

primaryKeyColumns: DataColumn[]

Ein Array von DataColumn-Objekten, die die Primärschlüsselspalten oder übergeordneten Spalten sind.

foreignKeyColumns: DataColumn[]

Ein Array von DataColumn-Objekten, die die Fremdschlüsselspalten oder untergeordneten Spalten sind.

Gibt zurück

Constraint

Ein neuer ForeignKeyConstraint.

Beispiele

Im folgenden Beispiel werden zwei Arrays von DataColumn -Objekten und dann zwei ForeignKeyConstraint Beziehungen zwischen zwei Tabellen in einem Dataset erstellt.

private void AddForeignConstraint(
    DataSet dataSet, DataTable table)
{
    try
    {
        DataColumn[] parentColumns = new DataColumn[2];
        DataColumn[] childColumns = new DataColumn[2];
        // Get the tables from the DataSet.
        DataTable customersTable = dataSet.Tables["Customers"];
        DataTable ordersTable = dataSet.Tables["Orders"];

        // Set Columns.
        parentColumns[0]=customersTable.Columns["id"];
        parentColumns[1]=customersTable.Columns["Name"];
        childColumns[0] = ordersTable.Columns["CustomerID"];
        childColumns[1] = ordersTable.Columns["CustomerName"];

        // Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint",
            parentColumns, childColumns);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint( _
ByVal dataSet As DataSet, ByVal table As DataTable)
    Try
        Dim parentColumns(1) As DataColumn
        Dim childColumns(1) As DataColumn
        ' Get the tables from the DataSet.
        Dim customersTable As DataTable = _
            dataSet.Tables("Customers")
        Dim ordersTable As DataTable = _
            dataSet.Tables("Orders")

        ' Set Columns.
        parentColumns(0) = customersTable.Columns("id")
        parentColumns(1) = customersTable.Columns("Name")
        childColumns(0) = ordersTable.Columns("CustomerID")
        childColumns(1) = ordersTable.Columns("CustomerName")

        ' Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint", _
            parentColumns, childColumns)

    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

Hinweise

Das CollectionChanged Ereignis tritt auf, wenn die Einschränkung erfolgreich hinzugefügt wurde.

Gilt für:

Freigeben über

ConstraintCollection.Add Methode

Definition

Überlädt

Add(Constraint)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(String, DataColumn, Boolean)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(String, DataColumn, DataColumn)

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für:

Add(String, DataColumn[], Boolean)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen