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

Überlädt

Name	Beschreibung
Add(Constraint)	Fügt das angegebene Constraint Objekt der Auflistung hinzu.
Add(String, DataColumn, Boolean)	Erstellt eine neue UniqueConstraint mit dem angegebenen Namen, und wert, der angibt, DataColumnob die Spalte ein Primärschlüssel ist, und fügt sie der Auflistung hinzu.
Add(String, DataColumn, DataColumn)	Erstellt eine neue ForeignKeyConstraint mit dem angegebenen Namen, der übergeordneten Spalte und der untergeordneten Spalte und fügt die Einschränkung der Auflistung hinzu.
Add(String, DataColumn[], Boolean)	Erstellt ein neues UniqueConstraint Objekt mit dem angegebenen Namen, dem Array von Objekten und dem DataColumn Wert, der angibt, ob es sich bei der Spalte um einen Primärschlüssel handelt, und fügt es der Auflistung hinzu.
Add(String, DataColumn[], DataColumn[])	Erstellt ein neues ForeignKeyConstraintArray mit den angegebenen Arrays von übergeordneten Spalten und untergeordneten Spalten und fügt die Einschränkung der Auflistung hinzu.

Add(Constraint)

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Fügt das angegebene Constraint Objekt der Auflistung 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

Der Constraint hinzuzufügende

Ausnahmen

ArgumentNullException

Das constraint Argument ist NULL.

ArgumentException

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

DuplicateNameException

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

Beispiele

Im folgenden Beispiel wird der UniqueConstraint ConstraintCollection Von einer .DataTable

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 erfolgreich durch Hinzufügen oder Entfernen von Einschränkungen geändert wird, tritt das CollectionChanged Ereignis auf.

Weitere Informationen

Gilt für:

Add(String, DataColumn, Boolean)

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Erstellt eine neue UniqueConstraint mit dem angegebenen Namen, und wert, der angibt, DataColumnob die Spalte ein Primärschlüssel ist, und fügt sie 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 des UniqueConstraint.

column: DataColumn

Die DataColumn Einschränkung, für die die Einschränkung gilt.

primaryKey: Boolean

Gibt an, ob die Spalte der Primärschlüssel sein soll. Wenn truedie Spalte eine Primärschlüsselspalte ist.

Gibt zurück

Constraint

Eine neue 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 weist bereits eine Einschränkung mit dem angegebenen Namen auf. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

Beispiele

Im folgenden Beispiel wird die Add Methode zum Erstellen und Hinzufügen eines neuen UniqueConstraint Elements ConstraintCollectionverwendet.

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 wird.

Weitere Informationen

UniqueConstraint

Gilt für:

Add(String, DataColumn, DataColumn)

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Erstellt eine neue ForeignKeyConstraint mit dem angegebenen Namen, der übergeordneten Spalte und der untergeordneten Spalte und fügt die Einschränkung der Auflistung 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 des ForeignKeyConstraint.

primaryKeyColumn: DataColumn

Der Primärschlüssel oder das übergeordnete Element. DataColumn

foreignKeyColumn: DataColumn

Der Fremdschlüssel oder untergeordnete DataColumnSchlüssel.

Gibt zurück

Constraint

Eine neue ForeignKeyConstraint.

Beispiele

Im folgenden Beispiel wird eine neue ForeignKeyConstraint zu ConstraintCollection einer .DataTable

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 wird.

Gilt für:

Add(String, DataColumn[], Boolean)

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Erstellt ein neues UniqueConstraint Objekt mit dem angegebenen Namen, dem Array von Objekten und dem DataColumn Wert, der angibt, ob es sich bei der Spalte um einen Primärschlüssel handelt, und fügt es 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 des UniqueConstraint.

columns: DataColumn[]

Ein Array von DataColumn Objekten, für das die Einschränkung gilt.

primaryKey: Boolean

Gibt an, ob die Spalte der Primärschlüssel sein soll. Wenn truedie Spalte eine Primärschlüsselspalte ist.

Gibt zurück

Constraint

Eine neue 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 weist bereits eine Einschränkung mit dem angegebenen Namen auf. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

Beispiele

Im folgenden Beispiel wird ein Array von DataColumn Objekten erstellt, die zum Erstellen eines neuen UniqueConstraint Objekts in einem bestimmten DataTableObjekt verwendet 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 wird.

Weitere Informationen

UniqueConstraint

Gilt für:

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

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Quelle:: ConstraintCollection.cs

Erstellt ein neues ForeignKeyConstraintArray mit den angegebenen Arrays von übergeordneten Spalten 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 des ForeignKeyConstraint.

primaryKeyColumns: DataColumn[]

Ein Array von DataColumn Objekten, die der Primärschlüssel oder übergeordnete Spalten sind.

foreignKeyColumns: DataColumn[]

Ein Array von DataColumn Objekten, die der Fremdschlüssel oder untergeordnete Spalten sind.

Gibt zurück

Constraint

Eine neue ForeignKeyConstraint.

Beispiele

Im folgenden Beispiel werden zwei Arrays von DataColumn Objekten erstellt 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 wird.

Gilt für:

Feedback

War diese Seite hilfreich?