ConstraintCollection.Add Metod

Definition

Namnområde:: System.Data

Sammansättning:: System.Data.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till ett Constraint objekt i samlingen.

Överlagringar

Name	Description
Add(Constraint)	Lägger till det angivna Constraint objektet i samlingen.
Add(String, DataColumn, Boolean)	Skapar en ny UniqueConstraint med det angivna namnet , DataColumnoch värdet som anger om kolumnen är en primärnyckel och lägger till den i samlingen.
Add(String, DataColumn, DataColumn)	Skapar en ny ForeignKeyConstraint med det angivna namnet, den överordnade kolumnen och den underordnade kolumnen och lägger till villkoret i samlingen.
Add(String, DataColumn[], Boolean)	Skapar en ny UniqueConstraint med det angivna namnet, matrisen med DataColumn objekt och värde som anger om kolumnen är en primärnyckel och lägger till den i samlingen.
Add(String, DataColumn[], DataColumn[])	Skapar en ny ForeignKeyConstraint, med de angivna matriserna med överordnade kolumner och underordnade kolumner, och lägger till villkoret i samlingen.

Add(Constraint)

Lägger till det angivna Constraint objektet i samlingen.

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)

Parametrar

constraint: Constraint

Att Constraint lägga till.

Undantag

ArgumentNullException

Argumentet constraint är null.

ArgumentException

Villkoret tillhör redan den här samlingen eller tillhör en annan samling.

DuplicateNameException

Samlingen har redan en begränsning med samma namn. (Jämförelsen är inte skiftlägeskänslig.)

Exempel

I följande exempel läggs en UniqueConstraint till i ConstraintCollection för en 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

Kommentarer

Om samlingen har ändrats genom att lägga till eller ta bort begränsningar inträffar händelsen CollectionChanged .

Se även

Gäller för

Add(String, DataColumn, Boolean)

Skapar en ny UniqueConstraint med det angivna namnet , DataColumnoch värdet som anger om kolumnen är en primärnyckel och lägger till den i samlingen.

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

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

public virtual 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);

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

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

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

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

Parametrar

name: String

Namnet på UniqueConstraint.

column: DataColumn

Den DataColumn begränsning som villkoret gäller för.

primaryKey: Boolean

Anger om kolumnen ska vara primärnyckeln. Om trueblir kolumnen en primärnyckelkolumn.

Returer

Constraint

En ny UniqueConstraint.

Undantag

ArgumentException

Villkoret tillhör redan den här samlingen.

-eller-

Villkoret tillhör en annan samling.

DuplicateNameException

Samlingen har redan en begränsning med det angivna namnet. (Jämförelsen är inte skiftlägeskänslig.)

Exempel

I följande exempel används Add metoden för att skapa och lägga till en ny UniqueConstraint i en ConstraintCollection.

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

Kommentarer

Händelsen CollectionChanged inträffar om villkoret har lagts till.

Se även

UniqueConstraint

Gäller för

Add(String, DataColumn, DataColumn)

Skapar en ny ForeignKeyConstraint med det angivna namnet, den överordnade kolumnen och den underordnade kolumnen och lägger till villkoret i samlingen.

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

public:
 System::Data::Constraint ^ Add(System::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);

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

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

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

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

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

Parametrar

name: String

Namnet på ForeignKeyConstraint.

primaryKeyColumn: DataColumn

Primärnyckeln, eller överordnad, DataColumn.

foreignKeyColumn: DataColumn

Sekundärnyckeln, eller underordnad, DataColumn.

Returer

Constraint

En ny ForeignKeyConstraint.

Exempel

I följande exempel läggs en ny ForeignKeyConstraint till i ConstraintCollection en 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

Kommentarer

Händelsen CollectionChanged inträffar om villkoret har lagts till.

Gäller för

Add(String, DataColumn[], Boolean)

Skapar en ny UniqueConstraint med det angivna namnet, matrisen med DataColumn objekt och värde som anger om kolumnen är en primärnyckel och lägger till den i samlingen.

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

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

public virtual 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);

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

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

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

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

Parametrar

name: String

Namnet på UniqueConstraint.

columns: DataColumn[]

En matris med DataColumn objekt som villkoret gäller för.

primaryKey: Boolean

Anger om kolumnen ska vara primärnyckeln. Om trueblir kolumnen en primärnyckelkolumn.

Returer

Constraint

En ny UniqueConstraint.

Undantag

ArgumentException

Villkoret tillhör redan den här samlingen.

-eller-

Villkoret tillhör en annan samling.

DuplicateNameException

Samlingen har redan en begränsning med det angivna namnet. (Jämförelsen är inte skiftlägeskänslig.)

Exempel

I följande exempel skapas en matris med DataColumn objekt som används för att skapa en ny UniqueConstraint i en specifik DataTable.

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

Kommentarer

Händelsen CollectionChanged inträffar om villkoret har lagts till.

Se även

UniqueConstraint

Gäller för

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

Skapar en ny ForeignKeyConstraint, med de angivna matriserna med överordnade kolumner och underordnade kolumner, och lägger till villkoret i samlingen.

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(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public virtual 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);

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

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

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

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

Parametrar

name: String

Namnet på ForeignKeyConstraint.

primaryKeyColumns: DataColumn[]

En matris med DataColumn objekt som är primärnyckeln eller överordnade kolumner.

foreignKeyColumns: DataColumn[]

En matris med DataColumn objekt som är sekundärnyckeln eller underordnade kolumner.

Returer

Constraint

En ny ForeignKeyConstraint.

Exempel

I följande exempel skapas två matriser med DataColumn objekt och två relationer skapas ForeignKeyConstraint mellan två tabeller i en datauppsättning.

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

Kommentarer

Händelsen CollectionChanged inträffar om villkoret har lagts till.

Gäller för

Feedback

Var den här sidan till hjälp?