DataRelationCollection.Add Método

Definição

Espaço de Nomes:: System.Data

Assemblagem:: System.Data.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Adiciona um DataRelation ao DataRelationCollection.

Sobrecargas

Name	Description
Add(DataRelation)	Adiciona um DataRelation ao DataRelationCollection.
Add(DataColumn, DataColumn)	Cria uma DataRelation com uma coluna de pai e filho especificadas, e adiciona-a à coleção.
Add(DataColumn[], DataColumn[])	Cria um DataRelation com as colunas pai e filho especificadas, e adiciona-o à coleção.
Add(String, DataColumn, DataColumn)	Cria um DataRelation com o nome especificado, e as colunas pai e filho, e adiciona-o à coleção.
Add(String, DataColumn[], DataColumn[])	Cria um DataRelation com o nome especificado e os arrays das colunas pai e filho, e adiciona-o à coleção.
Add(String, DataColumn, DataColumn, Boolean)	Cria um DataRelation com as colunas nome, pai e filho especificados, com restrições opcionais de acordo com o valor do `createConstraints` parâmetro, e adiciona-o à coleção.
Add(String, DataColumn[], DataColumn[], Boolean)	Cria um DataRelation com o nome especificado, arrays das colunas pai e filho, e o valor que especifica se deve criar uma restrição, e adiciona-o à coleção.

Add(DataRelation)

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

A DataRelation acrescentar à coleção.

Exceções

ArgumentNullException

O relation parâmetro é um valor nulo.

ArgumentException

A relação já pertence a esta 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 é sensível a maiúsculas e minúsculas.)

InvalidConstraintException

A relação entrou num estado inválido desde a sua criação.

Observações

Se a relação for adicionada com sucesso à coleção, o CollectionChanged evento ocorre.

Quando um DataRelation objeto é adicionado à coleção, ForeignKeyConstraint e UniqueConstraint os objetos são criados por defeito se ainda não existirem.

Ver também

Aplica-se a

Add(DataColumn, DataColumn)

Cria uma DataRelation com uma coluna de pai e filho especificadas, e adiciona-a à 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.

Devoluções

DataRelation

A relação criada.

Observações

Quando um DataRelation objeto é adicionado à coleção, ForeignKeyConstraint e UniqueConstraint os objetos são criados por defeito se ainda não existirem.

Ver também

Aplica-se a

Add(DataColumn[], DataColumn[])

Cria um DataRelation com as colunas pai e filho especificadas, e adiciona-o à 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 pais da relação.

childColumns: DataColumn[]

As colunas filhos da relação.

Devoluções

DataRelation

A relação criada.

Exceções

ArgumentException

A relação já pertence a esta 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 é sensível a maiúsculas e minúsculas.)

InvalidConstraintException

A relação entrou num estado inválido desde a sua criação.

Observações

Quando um DataRelation objeto é adicionado à coleção, ForeignKeyConstraint e UniqueConstraint os objetos são criados por defeito se ainda não existirem.

Ver também

Aplica-se a

Add(String, DataColumn, DataColumn)

Cria um DataRelation com o nome especificado, e as colunas pai e filho, e adiciona-o à 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.

Devoluções

DataRelation

A relação criada.

Observações

Quando um DataRelation objeto é adicionado à coleção, ForeignKeyConstraint e UniqueConstraint os objetos são criados por defeito se ainda não existirem.

Ver também

Aplica-se a

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

Cria um DataRelation com o nome especificado e os arrays das colunas pai e filho, e adiciona-o à 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 para criar.

parentColumns: DataColumn[]

Um array de objetos pais DataColumn .

childColumns: DataColumn[]

Um conjunto de objetos filhos DataColumn .

Devoluções

DataRelation

O criou DataRelation.

Exceções

ArgumentNullException

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

ArgumentException

A relação já pertence a esta 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 é sensível a maiúsculas e minúsculas.)

InvalidConstraintException

A relação entrou num estado inválido desde a sua criação.

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

Observações

Se a relação for adicionada com sucesso à coleção, o CollectionChanged evento ocorre.

Quando um DataRelation objeto é adicionado à coleção, ForeignKeyConstraint e UniqueConstraint os objetos são criados por defeito se ainda não existirem.

Ver também

Aplica-se a

Add(String, DataColumn, DataColumn, Boolean)

Cria um DataRelation com as colunas nome, pai e filho especificados, com restrições opcionais de acordo com o valor do createConstraints parâmetro, e adiciona-o à 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 criar restrições; caso contrário false. (O padrão é true).

Devoluções

DataRelation

A relação criada.

Observações

Quando um DataRelation objeto é adicionado à coleção, ForeignKeyConstraint e UniqueConstraint os objetos são criados por defeito se ainda não existirem. Para evitar isto, podes definir createConstraints como falso.

Ver também

Aplica-se a

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

Cria um DataRelation com o nome especificado, arrays das colunas pai e filho, e o valor que especifica se deve criar uma restrição, e adiciona-o à 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 para criar.

parentColumns: DataColumn[]

Um array de objetos pais DataColumn .

childColumns: DataColumn[]

Um conjunto de objetos filhos DataColumn .

createConstraints: Boolean

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

Devoluções

DataRelation

A relação criada.

Exceções

ArgumentNullException

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

ArgumentException

A relação já pertence a esta 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 é sensível a maiúsculas e minúsculas.)

InvalidConstraintException

A relação entrou num estado inválido desde a sua criação.

Observações

Quando um DataRelation objeto é adicionado à coleção, ForeignKeyConstraint e UniqueConstraint os objetos são criados por defeito se ainda não existirem.

Ver também

Aplica-se a

Comentários

Esta página foi útil?