DataRelation Класс

Определение

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

Наследование

Object

DataRelation

Атрибуты

TypeConverterAttribute SerializableAttribute

Примеры

В следующем примере создается новый DataRelation объект и добавляется в DataRelationCollectionDataSetобъект объекта .

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

Комментарии

Используется DataRelation для связи двух DataTable объектов друг с другом с помощью DataColumn объектов . Например, в отношениях "Клиент-заказы" таблица "Клиенты" является родительской, а таблица "Заказы" является дочерним элементом связи. Это похоже на связь первичного и внешнего ключей. Дополнительные сведения см. в разделе Навигация по даннымRelations.

Связи создаются между совпадающими столбцами в родительской и дочерней таблицах. То есть DataType значения для обоих столбцов должны быть идентичными.

Связи также могут каскадировать различные изменения от родительской DataRow к его дочерним строкам. Чтобы управлять изменением значений в дочерних строках, добавьте ForeignKeyConstraint в ConstraintCollectionDataTable объект объекта . Определяет ConstraintCollection , какое действие следует предпринять при удалении или обновлении значения в родительской таблице.

DataRelation При создании он сначала проверяет, можно ли установить связь. После добавления DataRelationCollectionв объект связь поддерживается путем запрета любых изменений, которые сделают ее недействительной. Между периодом DataRelation создания и добавления DataRelationCollectionв можно внести дополнительные изменения в родительские или дочерние строки. Исключение создается, если это вызывает связь, которая больше не является допустимой.

DataRelationОбъекты содержатся в объекте DataRelationCollection, к которому можно получить доступ через Relations свойство DataSet, а ChildRelations также свойства DataTableи ParentRelations объекта .

Конструкторы

Свойства

Методы

Применяется к

Потокобезопасность

Этот тип является безопасным для многопоточных операций чтения. Необходимо синхронизировать все операции записи.

См. также раздел

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