DataRelationCollection.Add Método

Definición

Espacio de nombres:: System.Data

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

Sobrecargas

Nombre	Description
Add(DataRelation)	Agrega un DataRelation al DataRelationCollection.
Add(DataColumn, DataColumn)	Crea un DataRelation con una columna primaria y secundaria especificada y la agrega a la colección.
Add(DataColumn[], DataColumn[])	Crea un DataRelation con las columnas primarias y secundarias especificadas y las agrega a la colección.
Add(String, DataColumn, DataColumn)	Crea un DataRelation con el nombre especificado y las columnas primarias y secundarias, y las agrega a la colección.
Add(String, DataColumn[], DataColumn[])	Crea un DataRelation con el nombre y las matrices especificados de columnas primarias y secundarias, y lo agrega a la colección.
Add(String, DataColumn, DataColumn, Boolean)	Crea un DataRelation con el nombre especificado, las columnas primarias y secundarias, con restricciones opcionales según el valor del parámetro `createConstraints` y lo agrega a la colección.
Add(String, DataColumn[], DataColumn[], Boolean)	Crea un DataRelation con el nombre especificado, las matrices de columnas primarias y secundarias, y el valor que especifica si se va a crear una restricción y se agrega a la colección.

Add(DataRelation)

Agrega un DataRelation al 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

que DataRelation se va a agregar a la colección.

Excepciones

ArgumentNullException

El relation parámetro es un valor null.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relación ha especificado 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 y ForeignKeyConstraint UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

Add(DataColumn, DataColumn)

Crea un 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 y ForeignKeyConstraint UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

Add(DataColumn[], DataColumn[])

Crea un DataRelation con las columnas primarias y secundarias especificadas y las 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

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

Comentarios

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

Consulte también

Se aplica a

Add(String, DataColumn, DataColumn)

Crea un DataRelation con el nombre especificado y las columnas primarias y secundarias, y las 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);

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 y ForeignKeyConstraint UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

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

Crea un DataRelation con el nombre y las matrices especificados de columnas primarias y secundarias, 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);

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 primarios DataColumn .

childColumns: DataColumn[]

Matriz de objetos secundarios DataColumn .

Devoluciones

DataRelation

Objeto creado DataRelation.

Excepciones

ArgumentNullException

El nombre de la relación es un valor null.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

La relación ha especificado 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 y ForeignKeyConstraint UniqueConstraint los objetos se crean de forma predeterminada si aún no existen.

Consulte también

Se aplica a

Add(String, DataColumn, DataColumn, Boolean)

Crea un DataRelation con el nombre especificado, las columnas primarias y secundarias, 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);

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; de lo contrario false, es . (El valor predeterminado es true).

Devoluciones

DataRelation

Relación creada.

Comentarios

Cuando se agrega un DataRelation objeto a la colección y ForeignKeyConstraint 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)

Crea un DataRelation con el nombre especificado, las matrices de columnas primarias y secundarias, y el valor que especifica si se va a crear una restricción y se 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);

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 primarios DataColumn .

childColumns: DataColumn[]

Matriz de objetos secundarios DataColumn .

createConstraints: Boolean

true para crear una restricción; de lo contrario false, es .

Devoluciones

DataRelation

Relación creada.

Excepciones

ArgumentNullException

El nombre de la relación es un valor null.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

Comentarios

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

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?