DataRelationCollection.Add Método

Definición

Sobrecargas

Add(DataRelation)

Agrega un objeto DataRelation a DataRelationCollection.Adds a DataRelation to the DataRelationCollection.

Add(DataColumn, DataColumn)

Crea una relación DataRelation con una columna primaria y secundaria especificada y la agrega a la colección.Creates a DataRelation with a specified parent and child column, and adds it to the collection.

Add(DataColumn[], DataColumn[])

Crea una relación DataRelation con las columnas primarias y secundarias especificadas y la agrega a la colección.Creates a DataRelation with the specified parent and child columns, and adds it to the collection.

Add(String, DataColumn, DataColumn)

Crea una relación DataRelation con el nombre y las columnas primarias y secundarias especificados y la agrega a la colección.Creates a DataRelation with the specified name, and parent and child columns, and adds it to the collection.

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

Crea una relación DataRelation con el nombre especificado y las matrices de columnas primarias y secundarias especificadas y la agrega a la colección.Creates a DataRelation with the specified name and arrays of parent and child columns, and adds it to the collection.

Add(String, DataColumn, DataColumn, Boolean)

Crea un objeto DataRelation con el nombre y las columnas primarias y secundarias que se especifiquen y con restricciones opcionales según el valor del parámetro createConstraints, y lo agrega a la colección.Creates a DataRelation with the specified name, parent and child columns, with optional constraints according to the value of the createConstraints parameter, and adds it to the collection.

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

Crea una relación DataRelation con el nombre, las matrices de columnas primarias y secundarias especificados y un valor que especifica si se debe crear una restricción y lo agrega a la colección.Creates a DataRelation with the specified name, arrays of parent and child columns, and value specifying whether to create a constraint, and adds it to the collection.

Add(DataRelation)

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)

Parámetros

relation
DataRelation

DataRelation que se agrega a la colección.The DataRelation to add to the collection.

Excepciones

El parámetro relation es un valor nulo.The relation parameter is a null value.

La relación ya pertenece a esta colección o a otra.The relation already belongs to this collection, or it belongs to another collection.

La colección ya tiene una relación con el nombre especificado.The collection already has a relation with the specified name. La comparación no distingue entre mayúsculas y minúsculas.(The comparison is not case sensitive.)

La relación ha introducido un estado no válido desde que se creó.The relation has entered an invalid state since it was created.

Comentarios

Si la relación se agrega correctamente a la colección, se produce el evento CollectionChanged.If the relation is successfully added to the collection, the CollectionChanged event occurs.

Cuando se agrega un objeto DataRelation a la colección, los objetos ForeignKeyConstraint y UniqueConstraint se crean de forma predeterminada si aún no existen.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Consulte también:

Add(DataColumn, DataColumn)

Crea una relación DataRelation con una columna primaria y secundaria especificada y la agrega a la colección.Creates a DataRelation with a specified parent and child column, and adds it to the collection.

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

Parámetros

parentColumn
DataColumn

Columna primaria de la relación.The parent column of the relation.

childColumn
DataColumn

Columna secundaria de la relación.The child column of the relation.

Devoluciones

Relación creada.The created relation.

Comentarios

Cuando se agrega un objeto DataRelation a la colección, los objetos ForeignKeyConstraint y UniqueConstraint se crean de forma predeterminada si aún no existen.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Consulte también:

Add(DataColumn[], DataColumn[])

Crea una relación DataRelation con las columnas primarias y secundarias especificadas y la agrega a la colección.Creates a DataRelation with the specified parent and child columns, and adds it to the collection.

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

Parámetros

parentColumns
DataColumn[]

Columnas primarias de la relación.The parent columns of the relation.

childColumns
DataColumn[]

Columnas secundarias de la relación.The child columns of the relation.

Devoluciones

Relación creada.The created relation.

Excepciones

El argumento relation es un valor nulo.The relation argument is a null value.

La relación ya pertenece a esta colección o a otra.The relation already belongs to this collection, or it belongs to another collection.

La colección ya tiene una relación con el mismo nombre.The collection already has a relation with the same name. La comparación no distingue entre mayúsculas y minúsculas.(The comparison is not case sensitive.)

La relación ha introducido un estado no válido desde que se creó.The relation has entered an invalid state since it was created.

Comentarios

Cuando se agrega un objeto DataRelation a la colección, los objetos ForeignKeyConstraint y UniqueConstraint se crean de forma predeterminada si aún no existen.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Consulte también:

Add(String, DataColumn, DataColumn)

Crea una relación DataRelation con el nombre y las columnas primarias y secundarias especificados y la agrega a la colección.Creates a DataRelation with the specified name, and parent and child columns, and adds it to the collection.

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

Parámetros

name
String

Nombre de la relación.The name of the relation.

parentColumn
DataColumn

Columna primaria de la relación.The parent column of the relation.

childColumn
DataColumn

Columna secundaria de la relación.The child column of the relation.

Devoluciones

Relación creada.The created relation.

Comentarios

Cuando se agrega un objeto DataRelation a la colección, los objetos ForeignKeyConstraint y UniqueConstraint se crean de forma predeterminada si aún no existen.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Consulte también:

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

Crea una relación DataRelation con el nombre especificado y las matrices de columnas primarias y secundarias especificadas y la agrega a la colección.Creates a DataRelation with the specified name and arrays of parent and child columns, and adds it to the collection.

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

Parámetros

name
String

Nombre del objeto DataRelation que se va a crear.The name of the DataRelation to create.

parentColumns
DataColumn[]

Matriz de objetos DataColumn primarios.An array of parent DataColumn objects.

childColumns
DataColumn[]

Matriz de objetos DataColumn secundarios.An array of child DataColumn objects.

Devoluciones

Objeto DataRelation creado.The created DataRelation.

Excepciones

El nombre de relación es un valor nulo.The relation name is a null value.

La relación ya pertenece a esta colección o a otra.The relation already belongs to this collection, or it belongs to another collection.

La colección ya tiene una relación con el mismo nombre.The collection already has a relation with the same name. La comparación no distingue entre mayúsculas y minúsculas.(The comparison is not case sensitive.)

La relación ha introducido un estado no válido desde que se creó.The relation has entered an invalid state since it was created.

Ejemplos

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

Comentarios

Si la relación se agrega correctamente a la colección, se produce el evento CollectionChanged.If the relation is successfully added to the collection, the CollectionChanged event occurs.

Cuando se agrega un objeto DataRelation a la colección, los objetos ForeignKeyConstraint y UniqueConstraint se crean de forma predeterminada si aún no existen.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Consulte también:

Add(String, DataColumn, DataColumn, Boolean)

Crea un objeto DataRelation con el nombre y las columnas primarias y secundarias que se especifiquen y con restricciones opcionales según el valor del parámetro createConstraints, y lo agrega a la colección.Creates a DataRelation with the specified name, parent and child columns, with optional constraints according to the value of the createConstraints parameter, and adds it to the collection.

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

Parámetros

name
String

Nombre de la relación.The name of the relation.

parentColumn
DataColumn

Columna primaria de la relación.The parent column of the relation.

childColumn
DataColumn

Columna secundaria de la relación.The child column of the relation.

createConstraints
Boolean

true para crear restricciones; en caso contrario, false.true to create constraints; otherwise false. El valor predeterminado es true.(The default is true).

Devoluciones

Relación creada.The created relation.

Comentarios

Cuando se agrega un objeto DataRelation a la colección, los objetos ForeignKeyConstraint y UniqueConstraint se crean de forma predeterminada si aún no existen.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist. Para evitarlo, puede establecer createConstraints en false.To prevent this, you can set createConstraints to false.

Consulte también:

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

Crea una relación DataRelation con el nombre, las matrices de columnas primarias y secundarias especificados y un valor que especifica si se debe crear una restricción y lo agrega a la colección.Creates a DataRelation with the specified name, arrays of parent and child columns, and value specifying whether to create a constraint, and adds it to the collection.

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

Parámetros

name
String

Nombre del objeto DataRelation que se va a crear.The name of the DataRelation to create.

parentColumns
DataColumn[]

Matriz de objetos DataColumn primarios.An array of parent DataColumn objects.

childColumns
DataColumn[]

Matriz de objetos DataColumn secundarios.An array of child DataColumn objects.

createConstraints
Boolean

true para crear una restricción; en caso contrario, false.true to create a constraint; otherwise false.

Devoluciones

Relación creada.The created relation.

Excepciones

El nombre de relación es un valor nulo.The relation name is a null value.

La relación ya pertenece a esta colección o a otra.The relation already belongs to this collection, or it belongs to another collection.

La colección ya tiene una relación con el mismo nombre.The collection already has a relation with the same name. La comparación no distingue entre mayúsculas y minúsculas.(The comparison is not case sensitive.)

La relación ha introducido un estado no válido desde que se creó.The relation has entered an invalid state since it was created.

Comentarios

Cuando se agrega un objeto DataRelation a la colección, los objetos ForeignKeyConstraint y UniqueConstraint se crean de forma predeterminada si aún no existen.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Consulte también:

Se aplica a