DataRelationCollection.Add Método

Definição

Sobrecargas

Add(DataRelation)

Adiciona um DataRelation ao DataRelationCollection.Adds a DataRelation to the DataRelationCollection.

Add(DataColumn, DataColumn)

Cria um DataRelation com uma coluna pai e filho especificada e a adiciona à coleção.Creates a DataRelation with a specified parent and child column, and adds it to the collection.

Add(DataColumn[], DataColumn[])

Cria um DataRelation com as colunas pai e filho especificadas e as adiciona à coleção.Creates a DataRelation with the specified parent and child columns, and adds it to the collection.

Add(String, DataColumn, DataColumn)

Cria um DataRelation com o nome e as colunas pai e filho especificadas e os adiciona à coleção.Creates a DataRelation with the specified name, and parent and child columns, and adds it to the collection.

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

Cria um DataRelation com o nome e as matrizes de colunas pai e filho especificadas e os adiciona à coleção.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)

Cria um DataRelation com o nome especificado e colunas pai e filho, com restrições opcionais de acordo com o valor do parâmetro createConstraints e o adiciona à coleção.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)

Cria um DataRelation com o nome especificado, matrizes de colunas pai e filho e um valor que especifica se uma restrição deve ser criada e o adiciona à coleção.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

O DataRelation a adicionar à coleção.The DataRelation to add to the collection.

Exceções

O parâmetro relation é um valor nulo.The relation parameter is a null value.

A relação já pertence a essa coleção ou pertence a outra coleção.The relation already belongs to this collection, or it belongs to another collection.

A coleção já tem uma relação com o nome especificado.The collection already has a relation with the specified name. (A comparação não diferencia maiúsculas de minúsculas.)(The comparison is not case sensitive.)

A relação entrou em um estado inválido desde que foi criada.The relation has entered an invalid state since it was created.

Comentários

Se a relação for adicionada com êxito à coleção, o CollectionChanged evento ocorrerá.If the relation is successfully added to the collection, the CollectionChanged event occurs.

Quando um DataRelation objeto é adicionado à coleção e os ForeignKeyConstraint UniqueConstraint objetos são criados por padrão, caso ainda não existam.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Aplica-se a

Add(DataColumn, DataColumn)

Cria um DataRelation com uma coluna pai e filho especificada e a adiciona à coleção.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

A coluna pai da relação.The parent column of the relation.

childColumn
DataColumn

A coluna filho da relação.The child column of the relation.

Retornos

DataRelation

A relação criada.The created relation.

Comentários

Quando um DataRelation objeto é adicionado à coleção e os ForeignKeyConstraint UniqueConstraint objetos são criados por padrão, caso ainda não existam.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Aplica-se a

Add(DataColumn[], DataColumn[])

Cria um DataRelation com as colunas pai e filho especificadas e as adiciona à coleção.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[]

As colunas pai da relação.The parent columns of the relation.

childColumns
DataColumn[]

As colunas filho da relação.The child columns of the relation.

Retornos

DataRelation

A relação criada.The created relation.

Exceções

O argumento relation é um valor nulo.The relation argument is a null value.

A relação já pertence a essa coleção ou pertence a outra coleção.The relation already belongs to this collection, or it belongs to another collection.

A coleção já tem uma relação com o mesmo nome.The collection already has a relation with the same name. (A comparação não diferencia maiúsculas de minúsculas.)(The comparison is not case sensitive.)

A relação entrou em um estado inválido desde que foi criada.The relation has entered an invalid state since it was created.

Comentários

Quando um DataRelation objeto é adicionado à coleção e os ForeignKeyConstraint UniqueConstraint objetos são criados por padrão, caso ainda não existam.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Aplica-se a

Add(String, DataColumn, DataColumn)

Cria um DataRelation com o nome e as colunas pai e filho especificadas e os adiciona à coleção.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);
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

O nome da relação.The name of the relation.

parentColumn
DataColumn

A coluna pai da relação.The parent column of the relation.

childColumn
DataColumn

A coluna filho da relação.The child column of the relation.

Retornos

DataRelation

A relação criada.The created relation.

Comentários

Quando um DataRelation objeto é adicionado à coleção e os ForeignKeyConstraint UniqueConstraint objetos são criados por padrão, caso ainda não existam.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Aplica-se a

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

Cria um DataRelation com o nome e as matrizes de colunas pai e filho especificadas e os adiciona à coleção.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);
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

O nome do DataRelation a ser criado.The name of the DataRelation to create.

parentColumns
DataColumn[]

Uma matriz de objetos DataColumn pai.An array of parent DataColumn objects.

childColumns
DataColumn[]

Uma matriz de objetos filho DataColumn .An array of child DataColumn objects.

Retornos

DataRelation

O DataRelation criado.The created DataRelation.

Exceções

O nome da relação é um valor nulo.The relation name is a null value.

A relação já pertence a essa coleção ou pertence a outra coleção.The relation already belongs to this collection, or it belongs to another collection.

A coleção já tem uma relação com o mesmo nome.The collection already has a relation with the same name. (A comparação não diferencia maiúsculas de minúsculas.)(The comparison is not case sensitive.)

A relação entrou em um estado inválido desde que foi criada.The relation has entered an invalid state since it was created.

Exemplos

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

Comentários

Se a relação for adicionada com êxito à coleção, o CollectionChanged evento ocorrerá.If the relation is successfully added to the collection, the CollectionChanged event occurs.

Quando um DataRelation objeto é adicionado à coleção e os ForeignKeyConstraint UniqueConstraint objetos são criados por padrão, caso ainda não existam.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Aplica-se a

Add(String, DataColumn, DataColumn, Boolean)

Cria um DataRelation com o nome especificado e colunas pai e filho, com restrições opcionais de acordo com o valor do parâmetro createConstraints e o adiciona à coleção.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);
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

O nome da relação.The name of the relation.

parentColumn
DataColumn

A coluna pai da relação.The parent column of the relation.

childColumn
DataColumn

A coluna filho da relação.The child column of the relation.

createConstraints
Boolean

true para criar restrições; caso contrário, false.true to create constraints; otherwise false. (O padrão é true).(The default is true).

Retornos

DataRelation

A relação criada.The created relation.

Comentários

Quando um DataRelation objeto é adicionado à coleção e os ForeignKeyConstraint UniqueConstraint objetos são criados por padrão, caso ainda não existam.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist. Para evitar isso, você pode definir createConstraints como false.To prevent this, you can set createConstraints to false.

Aplica-se a

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

Cria um DataRelation com o nome especificado, matrizes de colunas pai e filho e um valor que especifica se uma restrição deve ser criada e o adiciona à coleção.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);
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

O nome do DataRelation a ser criado.The name of the DataRelation to create.

parentColumns
DataColumn[]

Uma matriz de objetos DataColumn pai.An array of parent DataColumn objects.

childColumns
DataColumn[]

Uma matriz de objetos filho DataColumn .An array of child DataColumn objects.

createConstraints
Boolean

true para criar uma restrição; caso contrário, false.true to create a constraint; otherwise false.

Retornos

DataRelation

A relação criada.The created relation.

Exceções

O nome da relação é um valor nulo.The relation name is a null value.

A relação já pertence a essa coleção ou pertence a outra coleção.The relation already belongs to this collection, or it belongs to another collection.

A coleção já tem uma relação com o mesmo nome.The collection already has a relation with the same name. (A comparação não diferencia maiúsculas de minúsculas.)(The comparison is not case sensitive.)

A relação entrou em um estado inválido desde que foi criada.The relation has entered an invalid state since it was created.

Comentários

Quando um DataRelation objeto é adicionado à coleção e os ForeignKeyConstraint UniqueConstraint objetos são criados por padrão, caso ainda não existam.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Aplica-se a