DataRelationCollection.Add Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Adiciona um DataRelation ao DataRelationCollection.

Sobrecargas

Add(DataRelation)	Adiciona um DataRelation ao DataRelationCollection.
Add(DataColumn, DataColumn)	Cria um DataRelation com uma coluna pai e filho especificada e a adiciona à coleção.
Add(DataColumn[], DataColumn[])	Cria um DataRelation com as colunas pai e filho especificadas e as adiciona à coleção.
Add(String, DataColumn, DataColumn)	Cria um DataRelation com o nome e as colunas pai e filho especificadas e os adiciona à coleção.
Add(String, DataColumn[], DataColumn[])	Cria um DataRelation com o nome e as matrizes de colunas pai e filho especificadas e os adiciona à coleção.
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.
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.

Add(DataRelation)

Origem:

DataRelationCollection.cs

Adiciona um DataRelation ao 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

O DataRelation a adicionar à coleção.

Exceções

ArgumentNullException

O parâmetro relation é um valor nulo.

ArgumentException

A relação já pertence a essa coleção ou pertence a outra coleção.

DuplicateNameException

A coleção já tem uma relação com o nome especificado. (A comparação não diferencia maiúsculas de minúsculas.)

InvalidConstraintException

A relação entrou em um estado inválido desde que foi criada.

Comentários

Se a relação for adicionada com êxito à coleção, o CollectionChanged evento ocorrerá.

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraintUniqueConstraint os objetos são criados por padrão, se eles ainda não existirem.

Confira também

• Adicionando DataRelations
• Navegando em DataRelations

Add(DataColumn, DataColumn)

Origem:

DataRelationCollection.cs

Cria um DataRelation com uma coluna pai e filho especificada e a adiciona à coleção.

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.

childColumn

DataColumn

A coluna filho da relação.

Retornos

DataRelation

A relação criada.

Comentários

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraintUniqueConstraint os objetos são criados por padrão, se eles ainda não existirem.

Confira também

• Adicionando DataRelations
• Navegando em DataRelations

Add(DataColumn[], DataColumn[])

Origem:

DataRelationCollection.cs

Cria um DataRelation com as colunas pai e filho especificadas e as adiciona à coleção.

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.

childColumns

DataColumn[]

As colunas filho da relação.

Retornos

DataRelation

A relação criada.

Exceções

ArgumentNullException

O argumento relation é um valor nulo.

ArgumentException

A relação já pertence a essa coleção ou pertence a outra coleção.

DuplicateNameException

A coleção já tem uma relação com o mesmo nome. (A comparação não diferencia maiúsculas de minúsculas.)

InvalidConstraintException

A relação entrou em um estado inválido desde que foi criada.

Comentários

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraintUniqueConstraint os objetos são criados por padrão, se eles ainda não existirem.

Confira também

• Adicionando DataRelations
• Navegando em DataRelations

Add(String, DataColumn, DataColumn)

Origem:

DataRelationCollection.cs

Cria um DataRelation com o nome e as colunas pai e filho especificadas e os adiciona à coleção.

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

O nome da relação.

parentColumn

DataColumn

A coluna pai da relação.

childColumn

DataColumn

A coluna filho da relação.

Retornos

DataRelation

A relação criada.

Comentários

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraintUniqueConstraint os objetos são criados por padrão, se eles ainda não existirem.

Confira também

• Adicionando DataRelations
• Navegando em DataRelations

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

Origem:

DataRelationCollection.cs

Cria um DataRelation com o nome e as matrizes de colunas pai e filho especificadas e os adiciona à coleção.

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

O nome do DataRelation a ser criado.

parentColumns

DataColumn[]

Uma matriz de objetos DataColumn pai.

childColumns

DataColumn[]

Uma matriz de objetos filho DataColumn .

Retornos

DataRelation

O DataRelation criado.

Exceções

ArgumentNullException

O nome da relação é um valor nulo.

ArgumentException

A relação já pertence a essa coleção ou pertence a outra coleção.

DuplicateNameException

A coleção já tem uma relação com o mesmo nome. (A comparação não diferencia maiúsculas de minúsculas.)

InvalidConstraintException

A relação entrou em um estado inválido desde que foi criada.

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á.

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraintUniqueConstraint os objetos são criados por padrão, se eles ainda não existirem.

Confira também

• Adicionando DataRelations
• Navegando em DataRelations

Add(String, DataColumn, DataColumn, Boolean)

Origem:

DataRelationCollection.cs

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.

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

O nome da relação.

parentColumn

DataColumn

A coluna pai da relação.

childColumn

DataColumn

A coluna filho da relação.

createConstraints

Boolean

true para criar restrições; caso contrário, false. (O padrão é true).

Retornos

DataRelation

A relação criada.

Comentários

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraintUniqueConstraint os objetos são criados por padrão, se eles ainda não existirem. Para evitar isso, você pode definir createConstraints como false.

Confira também

• Adicionando DataRelations
• Navegando em DataRelations

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

Origem:

DataRelationCollection.cs

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.

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

O nome do DataRelation a ser criado.

parentColumns

DataColumn[]

Uma matriz de objetos DataColumn pai.

childColumns

DataColumn[]

Uma matriz de objetos filho DataColumn .

createConstraints

Boolean

true para criar uma restrição; caso contrário, false.

Retornos

DataRelation

A relação criada.

Exceções

ArgumentNullException

O nome da relação é um valor nulo.

ArgumentException

A relação já pertence a essa coleção ou pertence a outra coleção.

DuplicateNameException

A coleção já tem uma relação com o mesmo nome. (A comparação não diferencia maiúsculas de minúsculas.)

InvalidConstraintException

A relação entrou em um estado inválido desde que foi criada.

Comentários

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraintUniqueConstraint os objetos são criados por padrão, se eles ainda não existirem.

Confira também

• Adicionando DataRelations
• Navegando em DataRelations