Share via


DataRelation 생성자

정의

DataRelation 클래스의 새 인스턴스를 초기화합니다.

오버로드

DataRelation(String, DataColumn, DataColumn)

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

DataRelation(String, DataColumn[], DataColumn[])

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

DataRelation(String, DataColumn, DataColumn, Boolean)

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

DataRelation(String, DataColumn[], DataColumn[], Boolean)

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

DataRelation(String, String, String, String[], String[], Boolean)

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

DataRelation(String, String, String, String, String, String[], String[], Boolean)

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

DataRelation(String, DataColumn, DataColumn)

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

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

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public DataRelation (string? relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
public DataRelation (string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn)

매개 변수

relationName
String

DataRelation의 이름입니다. null 또는 빈 문자열("")의 경우 만든 개체가 DataRelationCollection에 추가될 때 기본 이름이 지정됩니다.

parentColumn
DataColumn

관계의 부모 DataColumn입니다.

childColumn
DataColumn

관계의 자식 DataColumn입니다.

예외

두 개의 DataColumn 개체 중 하나 이상에 null이 포함된 경우

열의 데이터 형식이 다른 경우

-또는-

테이블이 동일한 DataSet에 속하지 않는 경우

예제

다음 예제에서는 새 DataRelation 를 만들고 의 DataSetDataRelationCollection 추가합니다.

private void CreateRelation()
{
    // Code to get the DataSet not shown here.
    // Get the DataColumn objects from two DataTable
    // objects in a DataSet.
    DataColumn[] parentCols = new DataColumn[]
        {DataSet1.Tables["Customers"].Columns["CustID"],
        DataSet1.Tables["Customers"].Columns["OrdID"]};
    DataColumn[] childCols= new DataColumn[]
        {DataSet1.Tables["Orders"].Columns["CustID"],
        DataSet1.Tables["Orders"].Columns["OrdID"]};

    // Create DataRelation.
    DataRelation CustOrderRel = new DataRelation(
        "CustomersOrders", parentCols, childCols);

    // Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel);
}

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

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentCols, childCols)

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

추가 정보

적용 대상

DataRelation(String, DataColumn[], DataColumn[])

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

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

public:
 DataRelation(System::String ^ relationName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public DataRelation (string? relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
public DataRelation (string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn())

매개 변수

relationName
String

관계의 이름입니다. null 또는 빈 문자열("")의 경우 만든 개체가 DataRelationCollection에 추가될 때 기본 이름이 지정됩니다.

parentColumns
DataColumn[]

부모 DataColumn 개체로 이루어진 배열입니다.

childColumns
DataColumn[]

자식 DataColumn 개체로 이루어진 배열입니다.

예외

두 개의 DataColumn 개체 중 하나 이상에 null이 포함된 경우

DataColumn 개체의 데이터 형식이 다른 경우

-또는-

두 개의 배열 중 하나 이상이 동일한 테이블의 고유 열들로 구성되지 않은 경우

-또는-

테이블이 동일한 DataSet에 속하지 않는 경우

예제

다음 예제에서는 새 DataRelation 를 만들고 의 DataSetDataRelationCollection 추가합니다.

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

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns)

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

추가 정보

적용 대상

DataRelation(String, DataColumn, DataColumn, Boolean)

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

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

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);
public DataRelation (string? relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
public DataRelation (string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean)

매개 변수

relationName
String

관계의 이름입니다. null 또는 빈 문자열("")의 경우 만든 개체가 DataRelationCollection에 추가될 때 기본 이름이 지정됩니다.

parentColumn
DataColumn

관계의 부모 DataColumn입니다.

childColumn
DataColumn

관계의 자식 DataColumn입니다.

createConstraints
Boolean

제약 조건이 만들어지는지 여부를 나타내는 값입니다. 제약 조건이 만들어지면 true이고, 그렇지 않으면 false입니다.

예외

두 개의 DataColumn 개체 중 하나 이상에 null이 포함된 경우

열의 데이터 형식이 다른 경우

-또는-

테이블이 동일한 DataSet에 속하지 않는 경우

예제

다음 예제에서는 새 DataRelation 를 만들고 의 DataSetDataRelationCollection 추가합니다.


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

    ' Create DataRelation.
    Dim bConstraints As Boolean = True
    Dim customerOrdersRelation As DataRelation = _
        New DataRelation("CustomersOrders", _
        parentColumn, childColumn, bConstraints)

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

추가 정보

적용 대상

DataRelation(String, DataColumn[], DataColumn[], Boolean)

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

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

public:
 DataRelation(System::String ^ relationName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);
public DataRelation (string? relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
public DataRelation (string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean)

매개 변수

relationName
String

관계의 이름입니다. null 또는 빈 문자열("")의 경우 만든 개체가 DataRelationCollection에 추가될 때 기본 이름이 지정됩니다.

parentColumns
DataColumn[]

부모 DataColumn 개체로 이루어진 배열입니다.

childColumns
DataColumn[]

자식 DataColumn 개체로 이루어진 배열입니다.

createConstraints
Boolean

제약 조건을 만들지 여부를 나타내는 값입니다. 제약 조건이 만들어지면 true이고, 그렇지 않으면 false입니다.

예외

DataColumn 개체 중 하나 이상이 null인 경우

열의 데이터 형식이 다른 경우

-또는-

테이블이 동일한 DataSet에 속하지 않는 경우

예제

다음 예제에서는 새 DataRelation 를 만들고 의 DataSetDataRelationCollection 추가합니다.

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")
 
    Dim bConstraints As Boolean = True
    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns,  _
        bConstraints)

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

추가 정보

적용 대상

DataRelation(String, String, String, String[], String[], Boolean)

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

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

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ childTableName, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string? parentTableName, string? childTableName, string[]? parentColumnNames, string[]? childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string parentTableName, string childTableName, string[] parentColumnNames, string[] childColumnNames, bool nested);
[<System.ComponentModel.Browsable(false)>]
new System.Data.DataRelation : string * string * string * string[] * string[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentTableName As String, childTableName As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

매개 변수

relationName
String

관계의 이름입니다. null 또는 빈 문자열("")의 경우 만든 개체가 DataRelationCollection에 추가될 때 기본 이름이 지정됩니다.

parentTableName
String

관계의 부모 테이블인 DataTable의 이름입니다.

childTableName
String

관계의 자식 테이블인 DataTable의 이름입니다.

parentColumnNames
String[]

관계의 부모 DataColumn에 있는 DataTable 개체 이름으로 이루어진 배열입니다.

childColumnNames
String[]

관계의 자식 DataColumn에 있는 DataTable 개체 이름으로 이루어진 배열입니다.

nested
Boolean

관계가 중첩되는지 여부를 나타내는 값입니다.

특성

설명

이 생성자를 사용하여 만든 개체 DataRelation 는 및 EndInit 블록 내의 BeginInit 메서드를 사용하여 컬렉션에 AddRange 추가해야 합니다. 이 생성자가 와 사이에 BeginInitEndInit 호출되지 않으면 가 NullReferenceException 발생합니다. 또한 지정된 이름의 테이블과 열은 생성자가 호출될 때 존재해야 합니다.

적용 대상

DataRelation(String, String, String, String, String, String[], String[], Boolean)

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

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

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ parentTableNamespace, System::String ^ childTableName, System::String ^ childTableNamespace, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string? parentTableName, string? parentTableNamespace, string? childTableName, string? childTableNamespace, string[]? parentColumnNames, string[]? childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string parentTableName, string parentTableNamespace, string childTableName, string childTableNamespace, string[] parentColumnNames, string[] childColumnNames, bool nested);
[<System.ComponentModel.Browsable(false)>]
new System.Data.DataRelation : string * string * string * string * string * string[] * string[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentTableName As String, parentTableNamespace As String, childTableName As String, childTableNamespace As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

매개 변수

relationName
String

DataRelation의 이름입니다. null 또는 빈 문자열("")의 경우 만든 개체가 DataRelationCollection에 추가될 때 기본 이름이 지정됩니다.

parentTableName
String

관계의 부모 테이블인 DataTable의 이름입니다.

parentTableNamespace
String

부모 테이블 네임스페이스의 이름입니다.

childTableName
String

관계의 자식 테이블인 DataTable의 이름입니다.

childTableNamespace
String

자식 테이블 네임스페이스의 이름입니다.

parentColumnNames
String[]

관계의 부모 DataColumn에 있는 DataTable 개체 이름으로 이루어진 배열입니다.

childColumnNames
String[]

관계의 자식 DataColumn에 있는 DataTable 개체 이름으로 이루어진 배열입니다.

nested
Boolean

관계가 중첩되는지 여부를 나타내는 값입니다.

특성

설명

이 생성자를 사용하여 만든 개체 DataRelation 는 를 사용하여 컬렉션 AddRange에 추가해야 합니다. 지정된 이름의 테이블과 열은 메서드가 호출될 때 또는 이 생성자를 호출하기 전에 가 호출된 경우 BeginInit 지정된 이름의 테이블과 열이 EndInit 호출될 때 존재해야 합니다.

적용 대상