DataRelationCollection.Add Método

Referência

Definição

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Origem:: DataRelationCollection.cs

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 ForeignKeyConstraint UniqueConstraint 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

DataRelation

A relação criada.

Comentários

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraint UniqueConstraint 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

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 ForeignKeyConstraint UniqueConstraint 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

DataRelation

A relação criada.

Comentários

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraint UniqueConstraint 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

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 ForeignKeyConstraint UniqueConstraint 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

DataRelation

A relação criada.

Comentários

Quando um DataRelation objeto é adicionado à coleção e ForeignKeyConstraint UniqueConstraint 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

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 ForeignKeyConstraint UniqueConstraint os objetos são criados por padrão, se eles ainda não existirem.

Confira também

Aplica-se a

DataRelationCollection.Add Método

Definição

Sobrecargas

Add(DataRelation)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Add(DataColumn, DataColumn)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

Add(DataColumn[], DataColumn[])

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Add(String, DataColumn, DataColumn)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Add(String, DataColumn, DataColumn, Boolean)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Comentários

Recursos adicionais