Compartir a través de


DataRelationCollection.Add Método

Definición

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

El parámetro relation es un valor nulo.

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

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

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

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

Relación creada.

Excepciones

El argumento relation es un valor nulo.

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

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

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

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

Objeto DataRelation creado.

Excepciones

El nombre de relación es un valor nulo.

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

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

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

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

Relación creada.

Excepciones

El nombre de relación es un valor nulo.

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

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

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