DataRelation Sınıf

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Kaynak:

DataRelation.cs

İki DataTable nesne arasındaki üst/alt ilişkiyi temsil eder.

public ref class DataRelation

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

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

Public Class DataRelation

Devralma

Object

DataRelation

Öznitelikler

TypeConverterAttribute

Örnekler

Aşağıdaki örnek yeni DataRelation bir oluşturur ve öğesinin DataRelationCollectionöğesine DataSet ekler.

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

Açıklamalar

, DataRelation iki DataTable nesneyi nesneler aracılığıyla DataColumn birbiriyle ilişkilendirmek için kullanılır. Örneğin, Müşteri/Siparişler ilişkisinde Müşteriler tablosu üst tablo, Siparişler tablosu ise ilişkinin alt öğesidir. Bu, birincil anahtar/yabancı anahtar ilişkisine benzer. Daha fazla bilgi için bkz. DataRelations'ta Gezinme.

Üst ve alt tablolardaki eşleşen sütunlar arasında ilişkiler oluşturulur. Diğer bir ifadeyle, her iki sütunun DataType değeri de aynı olmalıdır.

İlişkiler ayrıca üst DataRow öğeden alt satırlarına çeşitli değişiklikleri art arda ekleyebilir. Alt satırlarda değerlerin nasıl değiştirildiğini denetlemek için nesnesinin ForeignKeyConstraintConstraintCollection öğesine bir DataTable ekleyin. üst ConstraintCollection tablodaki bir değer silindiğinde veya güncelleştirildiğinde hangi eylemin gerçekleştirileceğini belirler.

bir DataRelation oluşturulduğunda, önce ilişkinin kurulabileceğini doğrular. öğesine eklendikten DataRelationCollectionsonra, ilişki geçersiz kılınacak değişikliklere izin verilerek korunur. öğesinin oluşturulduğu ve öğesine eklendiği DataRelationdönem DataRelationCollection arasında üst veya alt satırlarda ek değişiklikler yapılabilir. Bu, artık geçerli olmayan bir ilişkiye neden olursa bir özel durum oluşturulur.

Note

İki tablo arasında çift yönlü bir ilişki tanımlanırsa veri bozulması oluşabilir. çift yönlü ilişki, üst-alt rolleri değiştirilmiş olarak aynı sütunları kullanan iki DataRelation nesneden oluşur. Nesneler kaydedildiğinde DataRelation özel durum oluşmaz; ancak veri bozulması oluşabilir.

DataRelationnesneleri içinde yer alırDataRelationCollection. Bu nesnelere , ve RelationsDataSet ve özellikleri ChildRelationsaracılığıyla ParentRelationsDataTableerişebilirsiniz.

Oluşturucular

Name	Description
DataRelation(String, DataColumn, DataColumn, Boolean)	Belirtilen adı, üst ve alt DataRelation nesneleri ve kısıtlamaların DataColumn oluşturulup oluşturulmayacağını gösteren bir değer kullanarak sınıfın yeni bir örneğini başlatır.
DataRelation(String, DataColumn, DataColumn)	Belirtilen DataRelation adı ve üst ve alt DataRelation nesneleri kullanarak sınıfın yeni bir örneğini DataColumn başlatır.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Belirtilen adı, eşleşen üst ve alt DataRelation nesne dizilerini ve kısıtlamaların DataColumn oluşturulup oluşturulmayacağını gösteren değeri kullanarak sınıfın yeni bir örneğini başlatır.
DataRelation(String, DataColumn[], DataColumn[])	Belirtilen DataRelation adı ve üst ve alt DataRelation nesnelerin eşleşen dizilerini kullanarak sınıfın yeni bir örneğini DataColumn başlatır.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Bu oluşturucu, Visual Studio ortamında tasarım zamanı desteği için sağlanır.
DataRelation(String, String, String, String[], String[], Boolean)	Bu oluşturucu, Visual Studio ortamında tasarım zamanı desteği için sağlanır.

Özellikler

Name	Description
ChildColumns	Bu ilişkinin alt DataColumn nesnelerini alır.
ChildKeyConstraint	İlişki için öğesini ForeignKeyConstraint alır.
ChildTable	Bu ilişkinin alt tablosunu alır.
DataSet	DataSet Ait olduğu değeri DataRelation alır.
ExtendedProperties	Özelleştirilmiş özellikleri depolayan koleksiyonu alır.
Nested	Nesnelerin iç içe olup olmadığını DataRelation gösteren bir değer alır veya ayarlar.
ParentColumns	Bu DataColumnöğesinin DataRelation üst sütunları olan bir nesne dizisi alır.
ParentKeyConstraint	öğesinin UniqueConstraint üst sütunundaki değerlerin benzersiz olduğunu garanti eden değerini DataRelation alır.
ParentTable	Bu DataTableöğesinin üst öğesini DataRelation alır.
RelationName	'den DataRelationalmak DataRelationCollection için kullanılan adı alır veya ayarlar.

Yöntemler

Name	Description
CheckStateForProperty()	Bu yöntem .NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnPropertyChanging(PropertyChangedEventArgs)	Bu üye .NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
RaisePropertyChanging(String)	Bu üye .NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
ToString()	RelationNameVarsa , alır.

İş Parçacığı Güvenliği

Bu tür, çok iş parçacıklı okuma işlemleri için güvenlidir. Tüm yazma işlemlerini eşitlemeniz gerekir.

Ayrıca bkz.

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