DataRelation Classe

Definição

public ref class DataRelation

[System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))]
public class DataRelation

public class DataRelation

[System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))]
[System.Serializable]
public class DataRelation

[<System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))>]
type DataRelation = class

type DataRelation = class

[<System.ComponentModel.TypeConverter(typeof(System.Data.RelationshipConverter))>]
[<System.Serializable>]
type DataRelation = class

Public Class DataRelation

Herança

Object

DataRelation

Atributos

TypeConverterAttribute SerializableAttribute

Exemplos

O exemplo a seguir cria um novo DataRelation e o adiciona ao DataRelationCollection de um DataSet.

private void CreateRelation()
{
    // Get the DataColumn objects from two DataTable objects
    // in a DataSet. Code to get the DataSet not shown here.
    DataColumn parentColumn =
        DataSet1.Tables["Customers"].Columns["CustID"];
    DataColumn childColumn =
        DataSet1.Tables["Orders"].Columns["CustID"];
    // Create DataRelation.
    DataRelation relCustOrder;
    relCustOrder = new DataRelation("CustomersOrders",
        parentColumn, childColumn);
    // Add the relation to the DataSet.
    DataSet1.Relations.Add(relCustOrder);
}

Private Sub CreateRelation()
    ' Get the DataColumn objects from two DataTable objects 
    ' in a DataSet. Code to get the DataSet not shown here.
    Dim parentColumn As DataColumn = _
        DataSet1.Tables("Customers").Columns("CustID")
    Dim childColumn As DataColumn = DataSet1.Tables( _
        "Orders").Columns("CustID")

    ' Create DataRelation.
    Dim relCustOrder As DataRelation
    relCustOrder = New DataRelation( _
        "CustomersOrders", parentColumn, childColumn)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(relCustOrder)
End Sub

Comentários

Um DataRelation é usado para relacionar dois DataTable objetos uns aos outros por meio DataColumn de objetos. Por exemplo, em uma relação Cliente/Pedidos, a tabela Clientes é o pai e a tabela Pedidos é o filho da relação. Isso é semelhante a uma relação chave primária/chave estrangeira. Para obter mais informações, consulte Navegar por DataRelations.

As relações são criadas entre colunas correspondentes nas tabelas pai e filho. Ou seja, o DataType valor para ambas as colunas deve ser idêntico.

As relações também podem cascata de várias alterações do pai DataRow para suas linhas filho. Para controlar como os valores são alterados em linhas filho, adicione um ForeignKeyConstraint ao ConstraintCollection objeto DataTable . Determina ConstraintCollection qual ação tomar quando um valor em uma tabela pai é excluído ou atualizado.

Quando um DataRelation é criado, primeiro verifica se a relação pode ser estabelecida. Depois de adicionada à DataRelationCollectionrelação, a relação é mantida, não permitindo alterações que a invalidem. Entre o período em que um DataRelation é criado e adicionado ao DataRelationCollection, é possível que alterações adicionais sejam feitas nas linhas pai ou filho. Uma exceção será gerada se isso causar uma relação que não é mais válida.

DataRelation os objetos estão contidos em um DataRelationCollection, que você pode acessar por meio da Relations propriedade do DataSet, e das ChildRelations propriedades e ParentRelations do DataTable.

Construtores

Propriedades

Métodos

Aplica-se a

Acesso thread-safe

Este tipo é seguro para operações de leitura e multithread. Você deve sincronizar todas as operações de gravação.

Confira também

• ChildRelations
• DataColumn
• DataSet
• ForeignKeyConstraint
• DataRelationCollection
• UniqueConstraint
• ParentRelations