DataRelation Kelas

Definisi

Ruang nama:

System.Data

Rakitan:

netstandard.dll, System.Data.Common.dll

Sumber:

DataRelation.cs

Mewakili hubungan induk/anak antara dua DataTable objek.

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

Warisan

Object

DataRelation

Atribut

TypeConverterAttribute

Contoh

Contoh berikut membuat baru DataRelation dan menambahkannya ke DataRelationCollection dari 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

Keterangan

digunakan DataRelation untuk menghubungkan dua DataTable objek satu sama lain melalui DataColumn objek. Misalnya, dalam hubungan Pelanggan/Pesanan, tabel Pelanggan adalah induk dan tabel Pesanan adalah turunan dari hubungan tersebut. Ini mirip dengan hubungan kunci primer/kunci asing. Untuk informasi selengkapnya, lihat Menavigasi DataRelations.

Hubungan dibuat antara kolom yang cocok dalam tabel induk dan anak. Artinya, DataType nilai untuk kedua kolom harus identik.

Hubungan juga dapat menyimpan berbagai perubahan dari induk DataRow ke baris turunannya. Untuk mengontrol bagaimana nilai diubah dalam baris turunan, tambahkan ForeignKeyConstraint ke ConstraintCollectionDataTable objek. ConstraintCollection menentukan tindakan apa yang harus diambil ketika nilai dalam tabel induk dihapus atau diperbarui.

DataRelation Ketika dibuat, pertama-tama memverifikasi bahwa hubungan dapat dibuat. Setelah ditambahkan ke DataRelationCollection, hubungan dipertahankan dengan melarang perubahan apa pun yang akan membatalkannya. Di antara periode ketika DataRelation dibuat dan ditambahkan ke DataRelationCollection, ada kemungkinan perubahan tambahan dilakukan pada baris induk atau turunan. Pengecualian dihasilkan jika ini menyebabkan hubungan yang tidak lagi valid.

Nota

Kerusakan data dapat terjadi jika hubungan dua arah didefinisikan di antara dua tabel. Relasi dua arah terdiri dari dua DataRelation objek yang menggunakan kolom yang sama, dengan peran induk-anak dialihkan. Tidak ada pengecualian yang dimunculkan ketika DataRelation objek disimpan; namun, kerusakan data dapat terjadi.

DataRelation objek terkandung dalam DataRelationCollection, yang dapat Anda akses melalui Relations properti DataSet, dan ChildRelations properti dan ParentRelations dari DataTable.

Konstruktor

Nama	Deskripsi
DataRelation(String, DataColumn, DataColumn, Boolean)	Menginisialisasi instans DataRelation baru kelas menggunakan nama, objek induk dan anak DataColumn yang ditentukan, dan nilai yang menunjukkan apakah akan membuat batasan.
DataRelation(String, DataColumn, DataColumn)	Menginisialisasi instans DataRelation baru kelas menggunakan nama yang ditentukan DataRelation , dan objek induk dan turunan DataColumn .
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Menginisialisasi instans DataRelation baru kelas menggunakan nama yang ditentukan, array objek induk dan anak DataColumn yang cocok, dan nilai yang menunjukkan apakah akan membuat batasan.
DataRelation(String, DataColumn[], DataColumn[])	Menginisialisasi instans DataRelation baru kelas menggunakan nama yang ditentukan DataRelation dan array objek induk dan turunan DataColumn yang cocok.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Konstruktor ini disediakan untuk dukungan waktu desain di lingkungan Visual Studio.
DataRelation(String, String, String, String[], String[], Boolean)	Konstruktor ini disediakan untuk dukungan waktu desain di lingkungan Visual Studio.

Properti

Nama	Deskripsi
ChildColumns	Mendapatkan objek anak DataColumn dari hubungan ini.
ChildKeyConstraint	ForeignKeyConstraint Mendapatkan untuk hubungan.
ChildTable	Mendapatkan tabel anak dari hubungan ini.
DataSet	Mendapatkan tempat DataSet yang DataRelation seharusnya.
ExtendedProperties	Mendapatkan koleksi yang menyimpan properti yang disesuaikan.
Nested	Mendapatkan atau menetapkan nilai yang menunjukkan apakah DataRelation objek ditumpuk.
ParentColumns	Mendapatkan array DataColumn objek yang merupakan kolom induk dari ini DataRelation.
ParentKeyConstraint	UniqueConstraint Mendapatkan yang menjamin bahwa nilai di kolom induk unikDataRelation.
ParentTable	Mendapatkan induk DataTable dari ini DataRelation.
RelationName	Mendapatkan atau mengatur nama yang digunakan untuk mengambil DataRelation dari DataRelationCollection.

Metode

Nama	Deskripsi
CheckStateForProperty()	Metode ini mendukung infrastruktur .NET dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnPropertyChanging(PropertyChangedEventArgs)	Anggota ini mendukung infrastruktur .NET dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
RaisePropertyChanging(String)	Anggota ini mendukung infrastruktur .NET dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
ToString()	RelationNameMendapatkan , jika ada.

Keamanan Thread

Jenis ini aman untuk operasi baca multithreaded. Anda harus menyinkronkan operasi tulis apa pun.

Lihat juga

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