Partilhar via


DataRelationCollection.Add Método

Definição

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
Origem:
DataRelationCollection.cs
Origem:
DataRelationCollection.cs
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

O parâmetro relation é um valor nulo.

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

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

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

Aplica-se a

Add(DataColumn, DataColumn)

Origem:
DataRelationCollection.cs
Origem:
DataRelationCollection.cs
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

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

Aplica-se a

Add(DataColumn[], DataColumn[])

Origem:
DataRelationCollection.cs
Origem:
DataRelationCollection.cs
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

A relação criada.

Exceções

O argumento relation é um valor nulo.

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

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

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

Aplica-se a

Add(String, DataColumn, DataColumn)

Origem:
DataRelationCollection.cs
Origem:
DataRelationCollection.cs
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);
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

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

Aplica-se a

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

Origem:
DataRelationCollection.cs
Origem:
DataRelationCollection.cs
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);
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

O DataRelation criado.

Exceções

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

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

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

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

Aplica-se a

Add(String, DataColumn, DataColumn, Boolean)

Origem:
DataRelationCollection.cs
Origem:
DataRelationCollection.cs
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);
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

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

Aplica-se a

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

Origem:
DataRelationCollection.cs
Origem:
DataRelationCollection.cs
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);
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

A relação criada.

Exceções

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

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

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

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

Aplica-se a