ConstraintCollection.Add Método

Referencia

Definición

Espacio de nombres:: System.Data

Ensamblado:: System.Data.Common.dll

Ensamblado:: System.Data.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Agrega un objeto Constraint a la colección.

Sobrecargas

Add(Constraint)	Agrega a la colección el objeto Constraint especificado.
Add(String, DataColumn, Boolean)	Construye una nueva restricción UniqueConstraint con el nombre especificado, el objeto DataColumn y un valor que indica si la columna es una clave principal, y la agrega a la colección.
Add(String, DataColumn, DataColumn)	Construye una nueva restricción ForeignKeyConstraint con el nombre, columna primaria y columna secundaria especificados, y agrega la restricción a la colección.
Add(String, DataColumn[], Boolean)	Crea una nueva restricción UniqueConstraint con el nombre especificado, la matriz de objetos DataColumn y un valor que indica si la columna es una clave principal, y la agrega a la colección.
Add(String, DataColumn[], DataColumn[])	Construye una nueva restricción ForeignKeyConstraint con las matrices de columnas primarias y secundarias especificadas y agrega la restricción a la colección.

Add(Constraint)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Agrega a la colección el objeto Constraint especificado.

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)

Parámetros

constraint: Constraint

Constraint que se va a agregar.

Excepciones

ArgumentNullException

El argumento constraint es null.

ArgumentException

La restricción ya pertenece a esta colección o pertenece a otra colección.

DuplicateNameException

La colección ya tiene una restricción con el mismo nombre. (La comparación no distingue entre mayúsculas y minúsculas).

Ejemplos

En el ejemplo siguiente se agrega un UniqueConstraint objeto a ConstraintCollection de .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

Comentarios

Si la colección cambia correctamente agregando o quitando restricciones, se produce el CollectionChanged evento .

Consulte también

Se aplica a

Add(String, DataColumn, Boolean)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Construye una nueva restricción UniqueConstraint con el nombre especificado, el objeto DataColumn y un valor que indica si la columna es una clave principal, y la agrega a la colección.

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

Parámetros

name: String

Nombre del objeto UniqueConstraint.

column: DataColumn

Columna DataColumn a la que se aplica la restricción.

primaryKey: Boolean

Especifica si la columna debe ser la clave principal. Si es true, la columna será una columna de clave principal.

Devoluciones

Constraint

Un nuevo objeto UniqueConstraint.

Excepciones

ArgumentException

La restricción ya pertenece a esta colección.

-O bien-

La restricción pertenece a otra colección.

DuplicateNameException

La colección ya tiene una restricción con el nombre especificado. (La comparación no distingue entre mayúsculas y minúsculas).

Ejemplos

En el ejemplo siguiente se usa el Add método para crear y agregar un nuevo UniqueConstraint a .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

Comentarios

El CollectionChanged evento se produce si la restricción se agrega correctamente.

Consulte también

UniqueConstraint

Se aplica a

Add(String, DataColumn, DataColumn)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Construye una nueva restricción ForeignKeyConstraint con el nombre, columna primaria y columna secundaria especificados, y agrega la restricción a la colección.

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

Parámetros

name: String

Nombre del objeto ForeignKeyConstraint.

primaryKeyColumn: DataColumn

Columna DataColumn de clave principal o primaria.

foreignKeyColumn: DataColumn

Columna DataColumn de clave externa o secundaria.

Devoluciones

Constraint

Un nuevo objeto ForeignKeyConstraint.

Ejemplos

En el ejemplo siguiente se agrega un nuevo ForeignKeyConstraint objeto a ConstraintCollection de .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

Comentarios

El CollectionChanged evento se produce si la restricción se agrega correctamente.

Se aplica a

Add(String, DataColumn[], Boolean)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Crea una nueva restricción UniqueConstraint con el nombre especificado, la matriz de objetos DataColumn y un valor que indica si la columna es una clave principal, y la agrega a la colección.

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

Parámetros

name: String

Nombre del objeto UniqueConstraint.

columns: DataColumn[]

Matriz de objetos DataColumn a la que se aplica la restricción.

primaryKey: Boolean

Especifica si la columna debe ser la clave principal. Si es true, la columna será una columna de clave principal.

Devoluciones

Constraint

Un nuevo objeto UniqueConstraint.

Excepciones

ArgumentException

La restricción ya pertenece a esta colección.

-O bien-

La restricción pertenece a otra colección.

DuplicateNameException

La colección ya tiene una restricción con el nombre especificado. (La comparación no distingue entre mayúsculas y minúsculas).

Ejemplos

En el ejemplo siguiente se crea una matriz de DataColumn objetos que se usan para crear un objeto en UniqueConstraint un elemento específico 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

Comentarios

El CollectionChanged evento se produce si la restricción se agrega correctamente.

Consulte también

UniqueConstraint

Se aplica a

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

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Construye una nueva restricción ForeignKeyConstraint con las matrices de columnas primarias y secundarias especificadas y agrega la restricción a la colección.

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

Parámetros

name: String

Nombre del objeto ForeignKeyConstraint.

primaryKeyColumns: DataColumn[]

Matriz de objetos DataColumn que son las columnas de clave primaria o principal.

foreignKeyColumns: DataColumn[]

Matriz de objetos DataColumn que son las columnas de clave externa o secundaria.

Devoluciones

Constraint

Un nuevo objeto ForeignKeyConstraint.

Ejemplos

En el ejemplo siguiente se crean dos matrices de DataColumn objetos y, a continuación, se crean dos ForeignKeyConstraint relaciones entre dos tablas de un conjunto de datos.

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

Comentarios

El CollectionChanged evento se produce si la restricción se agrega correctamente.

Se aplica a

Compartir a través de

ConstraintCollection.Add Método

Definición

Sobrecargas

Add(Constraint)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Add(String, DataColumn, Boolean)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Add(String, DataColumn, DataColumn)

Parámetros

Devoluciones

Ejemplos

Comentarios

Se aplica a

Add(String, DataColumn[], Boolean)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Ejemplos

Comentarios

Se aplica a

Recursos adicionales