DataRelationCollection.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 DataRelation a DataRelationCollection.

Sobrecargas

Add(DataRelation)	Agrega un objeto DataRelation a DataRelationCollection.
Add(DataColumn, DataColumn)	Crea una relación DataRelation con una columna primaria y secundaria especificada y la agrega a la colección.
Add(DataColumn[], DataColumn[])	Crea una relación DataRelation con las columnas primarias y secundarias especificadas y la agrega a la colecció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.
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.
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.
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.

Add(DataRelation)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Agrega un objeto DataRelation a DataRelationCollection.

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.

Excepciones

ArgumentNullException

El parámetro relation es un valor nulo.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relación ha introducido un estado no válido desde que se creó.

Comentarios

Si la relación se agrega correctamente a la colección, se produce el CollectionChanged evento .

Cuando se agrega un DataRelation objeto a la colección ForeignKeyConstraint y UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

Add(DataColumn, DataColumn)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crea una relación DataRelation con una columna primaria y secundaria especificada y la agrega a la colección.

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.

childColumn: DataColumn

Columna secundaria de la relación.

Devoluciones

DataRelation

Relación creada.

Comentarios

Cuando se agrega un DataRelation objeto a la colección ForeignKeyConstraint y UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

Add(DataColumn[], DataColumn[])

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crea una relación DataRelation con las columnas primarias y secundarias especificadas y la agrega a la colección.

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.

childColumns: DataColumn[]

Columnas secundarias de la relación.

Devoluciones

DataRelation

Relación creada.

Excepciones

ArgumentNullException

El argumento relation es un valor nulo.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relación ha introducido un estado no válido desde que se creó.

Comentarios

Cuando se agrega un DataRelation objeto a la colección ForeignKeyConstraint y UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

Add(String, DataColumn, DataColumn)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Crea una relación DataRelation con el nombre y las columnas primarias y secundarias especificados y la agrega a la colección.

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

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.

parentColumn: DataColumn

Columna primaria de la relación.

childColumn: DataColumn

Columna secundaria de la relación.

Devoluciones

DataRelation

Relación creada.

Comentarios

Cuando se agrega un DataRelation objeto a la colección ForeignKeyConstraint y UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

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

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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.

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

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.

parentColumns: DataColumn[]

Matriz de objetos DataColumn primarios.

childColumns: DataColumn[]

Matriz de objetos DataColumn secundarios.

Devoluciones

DataRelation

Objeto DataRelation creado.

Excepciones

ArgumentNullException

El nombre de relación es un valor nulo.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relación ha introducido un estado no válido desde que se creó.

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 CollectionChanged evento .

Cuando se agrega un DataRelation objeto a la colección ForeignKeyConstraint y UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

Add(String, DataColumn, DataColumn, Boolean)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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.

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

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.

parentColumn: DataColumn

Columna primaria de la relación.

childColumn: DataColumn

Columna secundaria de la relación.

createConstraints: Boolean

true para crear restricciones; en caso contrario, false. El valor predeterminado es true.

Devoluciones

DataRelation

Relación creada.

Comentarios

Cuando se agrega un DataRelation objeto a la colección ForeignKeyConstraint y UniqueConstraint los objetos se crean de forma predeterminada si aún no existen. Para evitar esto, puede establecer en createConstraints false.

Consulte también

Se aplica a

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

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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.

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

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.

parentColumns: DataColumn[]

Matriz de objetos DataColumn primarios.

childColumns: DataColumn[]

Matriz de objetos DataColumn secundarios.

createConstraints: Boolean

true para crear una restricción; en caso contrario, false.

Devoluciones

DataRelation

Relación creada.

Excepciones

ArgumentNullException

El nombre de relación es un valor nulo.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relación ha introducido un estado no válido desde que se creó.

Comentarios

Cuando se agrega un DataRelation objeto a la colección ForeignKeyConstraint y UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

Compartir a través de

DataRelationCollection.Add Método

Definición

Sobrecargas

Add(DataRelation)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Add(DataColumn, DataColumn)

Parámetros

Devoluciones

Comentarios

Consulte también

Se aplica a

Add(DataColumn[], DataColumn[])

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

Add(String, DataColumn, DataColumn)

Parámetros

Devoluciones

Comentarios

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Add(String, DataColumn, DataColumn, Boolean)

Parámetros

Devoluciones

Comentarios

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

Recursos adicionales