DataRelationCollection.Add Método
Definición
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 |
| 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 -> unitPublic 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.DataRelationPublic Overridable Function Add (parentColumn As DataColumn, childColumn As DataColumn) As DataRelationPará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.DataRelationPublic Overridable Function Add (parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelationPará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.DataRelationPublic Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn) As DataRelationPará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.DataRelationPublic Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelationPará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.DataRelationPublic Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean) As DataRelationPará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.DataRelationPublic Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean) As DataRelationPará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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de