DataRelation 클래스

  • 참조

정의

네임스페이스:
System.Data
어셈블리:
System.Data.Common.dll
어셈블리:
System.Data.dll
어셈블리:
netstandard.dll

두 DataTable 개체 사이의 부모/자식 관계를 나타냅니다.

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 항목을 만들어서 에 추가 DataRelationCollection 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

설명

A DataRelation 는 개체를 통해 DataColumn 두 DataTable 개체를 서로 연결하기 위해 사용됩니다. 예를 들어 고객/주문 관계에서 Customers 테이블은 부모이고 Orders 테이블은 관계의 자식입니다. 이는 기본 키/외래 키 관계와 유사합니다. 자세한 내용은 DataRelations 탐색을 참조하세요.

부모 테이블과 자식 테이블의 일치하는 열 간에 관계가 만들어집니다. 즉, 두 열의 DataType 값은 동일해야 합니다.

관계는 부모 DataRow 에서 자식 행으로 다양한 변경 내용을 연계할 수도 있습니다. 자식 행에서 값이 변경되는 방식을 제어하려면 개체에 ConstraintCollection DataTable 값을 ForeignKeyConstraint 추가합니다. 부모 ConstraintCollection 테이블의 값을 삭제하거나 업데이트할 때 수행할 작업을 결정합니다.

만들 DataRelation 때 먼저 관계를 설정할 수 있는지 확인합니다. 관계가 추가 DataRelationCollection되면 관계가 무효화되는 변경 내용을 허용하지 않음으로써 유지 관리됩니다. 생성 DataRelation 되고 해당 행에 DataRelationCollection추가되는 기간 사이에 부모 또는 자식 행에 대한 추가 변경이 가능합니다. 이로 인해 더 이상 유효하지 않은 관계가 발생하는 경우 예외가 생성됩니다.

참고

두 테이블 간에 양방향 관계가 정의되면 데이터 손상이 발생할 수 있습니다. 양방향 관계는 부모-자식 역할이 전환된 상태에서 동일한 열을 사용하는 두 개체 DataRelation 로 구성됩니다. 개체를 DataRelation 저장할 때 예외가 발생하지 않습니다. 그러나 데이터 손상이 발생할 수 있습니다.

DataRelation objects are contained in a DataRelationCollection, which you can access through the Relations property of the DataSet, and the ChildRelations and ParentRelations properties of the DataTable.

생성자

DataRelation(String, DataColumn, DataColumn)

지정된 DataRelation 이름과 부모 및 자식 DataRelation 개체를 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.
DataRelation(String, DataColumn, DataColumn, Boolean)

지정된 이름, 부모 및 자식 DataRelation 개체, 제약 조건을 만들지 여부를 나타내는 값 등을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.
DataRelation(String, DataColumn[], DataColumn[])

부모 및 자식 DataRelation 개체의 일치되는 배열과 지정된 DataRelation 이름을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.
DataRelation(String, DataColumn[], DataColumn[], Boolean)

지정된 이름, 부모 및 자식 DataRelation 개체의 일치되는 배열, 제약 조건을 만들지 여부를 나타내는 값 등을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.
DataRelation(String, String, String, String, String, String[], String[], Boolean)

이 생성자는 Visual Studio 환경에서 디자인 타임 지원을 위해 제공됩니다.
DataRelation(String, String, String, String[], String[], Boolean)

이 생성자는 Visual Studio 환경에서 디자인 타임 지원을 위해 제공됩니다.

속성

ChildColumns

이 관계의 자식 DataColumn 개체를 가져옵니다.
ChildKeyConstraint

관계의 ForeignKeyConstraint를 가져옵니다.
ChildTable

이 관계의 자식 테이블을 가져옵니다.
DataSet

DataSet이 속하는 DataRelation을 가져옵니다.
ExtendedProperties

사용자 지정 속성을 저장하는 컬렉션을 가져옵니다.
Nested

DataRelation 개체가 중첩되는지 여부를 나타내는 값을 가져오거나 설정합니다.
ParentColumns

이 DataColumn의 부모 열인 DataRelation 개체로 이루어진 배열을 가져옵니다.
ParentKeyConstraint

UniqueConstraint의 부모 열에 있는 값을 고유하게 하는 DataRelation를 가져옵니다.
ParentTable

이 DataTable의 부모 DataRelation를 가져옵니다.
RelationName

DataRelation에서 DataRelationCollection을 검색하는 데 사용되는 이름을 가져오거나 설정합니다.

메서드

CheckStateForProperty()

이 메서드는 .NET 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다.
Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
OnPropertyChanging(PropertyChangedEventArgs)

이 멤버는 .NET 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.
RaisePropertyChanging(String)

이 멤버는 .NET 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.
ToString()

RelationName이 있는 경우 가져옵니다.

적용 대상

스레드 보안

이 형식은 다중 스레드 읽기 작업에 안전합니다. 모든 쓰기 작업을 동기화해야 합니다.

추가 정보