ConstraintCollection.Add 메서드

정의

네임스페이스:: System.Data

어셈블리:: netstandard.dll, System.Data.Common.dll

어셈블리:: System.Data.Common.dll

어셈블리:: System.Data.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

컬렉션에 Constraint 개체를 추가합니다.

오버로드

Name	Description
Add(Constraint)	컬렉션에 지정된 Constraint 개체를 추가합니다.
Add(String, DataColumn, Boolean)	지정된 이름과 UniqueConstraint열이 기본 키인지 여부를 나타내는 값을 사용하여 새 DataColumn 열을 생성하고 컬렉션에 추가합니다.
Add(String, DataColumn, DataColumn)	지정된 이름, 부모 열 및 자식 열을 사용하여 새 ForeignKeyConstraint 열을 생성하고 컬렉션에 제약 조건을 추가합니다.
Add(String, DataColumn[], Boolean)	지정된 이름, 개체 배열 UniqueConstraint 및 열이 기본 키인지 여부를 나타내는 값을 사용하여 새 DataColumn 열을 생성하고 컬렉션에 추가합니다.
Add(String, DataColumn[], DataColumn[])	부모 열 및 자식 열의 지정된 배열을 사용하여 새 ForeignKeyConstraint열을 생성하고 컬렉션에 제약 조건을 추가합니다.

Add(Constraint)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

컬렉션에 지정된 Constraint 개체를 추가합니다.

public:
 void Add(System::Data::Constraint ^ constraint);

public void Add(System.Data.Constraint constraint);

member this.Add : System.Data.Constraint -> unit

Public Sub Add (constraint As Constraint)

매개 변수

constraint: Constraint

추가할 개체입니다 Constraint .

예외

ArgumentNullException

인수가 constraint null입니다.

ArgumentException

제약 조건은 이미 이 컬렉션에 속하거나 다른 컬렉션에 속합니다.

DuplicateNameException

컬렉션에 이름이 같은 제약 조건이 이미 있습니다. (비교는 대/소문자를 구분하지 않습니다.)

예제

다음 예제에서는 에 a UniqueConstraint 를 ConstraintCollection 추가합니다 DataTable.

private void AddConstraint(DataTable table)
{
    UniqueConstraint uniqueConstraint;
    // Assuming a column named "UniqueColumn" exists, and
    // its Unique property is true.
    uniqueConstraint = new UniqueConstraint(
        table.Columns["UniqueColumn"]);
    table.Constraints.Add(uniqueConstraint);
}

Private Sub AddConstraint(table As DataTable)
    Dim uniqueConstraint As UniqueConstraint
    ' Assuming a column named "UniqueColumn" exists, and 
    ' its Unique property is true.
    uniqueConstraint = _
       New UniqueConstraint(table.Columns("UniqueColumn"))
    table.Constraints.Add(uniqueConstraint)
End Sub

설명

제약 조건을 CollectionChanged 추가하거나 제거하여 컬렉션이 성공적으로 변경되면 이벤트가 발생합니다.

추가 정보

적용 대상

Add(String, DataColumn, Boolean)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

지정된 이름과 UniqueConstraint열이 기본 키인지 여부를 나타내는 값을 사용하여 새 DataColumn 열을 생성하고 컬렉션에 추가합니다.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);

public System.Data.Constraint Add(string? name, System.Data.DataColumn column, bool primaryKey);

public System.Data.Constraint Add(string name, System.Data.DataColumn column, bool primaryKey);

public virtual System.Data.Constraint Add(string name, System.Data.DataColumn column, bool primaryKey);

member this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint

abstract member Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint

Public Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Public Overridable Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

매개 변수

name: String

UniqueConstraint의 이름입니다.

column: DataColumn

DataColumn 제약 조건이 적용되는 대상입니다.

primaryKey: Boolean

열이 기본 키여야 하는지 여부를 지정합니다. 이 경우 true열은 기본 키 열이 됩니다.

반품

Constraint

새 UniqueConstraint.

예외

ArgumentException

제약 조건이 이미 이 컬렉션에 속합니다.

-또는-

제약 조건은 다른 컬렉션에 속합니다.

DuplicateNameException

컬렉션에 이미 지정된 이름의 제약 조건이 있습니다. (비교는 대/소문자를 구분하지 않습니다.)

예제

다음 예제에서는 메서드를 Add 사용하여 새로 UniqueConstraint 만들고 새 메서드를 추가합니다 ConstraintCollection.

private void AddUniqueConstraint(DataTable table){
   table.Constraints.Add("idConstraint", table.Columns["id"], true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    table.Constraints.Add("idConstraint", table.Columns("id"), True)
End Sub

설명

제약 CollectionChanged 조건이 성공적으로 추가되면 이벤트가 발생합니다.

추가 정보

UniqueConstraint

적용 대상

Add(String, DataColumn, DataColumn)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

지정된 이름, 부모 열 및 자식 열을 사용하여 새 ForeignKeyConstraint 열을 생성하고 컬렉션에 제약 조건을 추가합니다.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);

public System.Data.Constraint Add(string? name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

public System.Data.Constraint Add(string name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

public virtual System.Data.Constraint Add(string name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

member this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint

abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint

Public Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Public Overridable Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

매개 변수

name: String

ForeignKeyConstraint의 이름입니다.

primaryKeyColumn: DataColumn

기본 키 또는 부모 DataColumn입니다.

foreignKeyColumn: DataColumn

외래 키 또는 자식 DataColumn입니다.

반품

Constraint

새 ForeignKeyConstraint.

예제

다음 예제에서는 에 새 ForeignKeyConstraint 값을 ConstraintCollection 추가합니다 DataTable.

private void AddForeignConstraint(DataSet dataSet)
{
    try
    {
        DataColumn parentColumn =
            dataSet.Tables["Suppliers"].Columns["SupplierID"];
        DataColumn childColumn =
            dataSet.Tables["Products"].Columns["SupplierID"];
        dataSet.Tables["Products"].Constraints.Add
            ("ProductsSuppliers", parentColumn, childColumn);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint(dataSet As DataSet)
    Try
        Dim parentColumn As DataColumn = _
            dataSet.Tables("Suppliers").Columns("SupplierID")
        Dim childColumn As DataColumn = _
            dataSet.Tables("Products").Columns("SupplierID")
        dataSet.Tables("Products").Constraints.Add _
            ("ProductsSuppliers", parentColumn, childColumn)
        
    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

설명

제약 CollectionChanged 조건이 성공적으로 추가되면 이벤트가 발생합니다.

적용 대상

Add(String, DataColumn[], Boolean)

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

지정된 이름, 개체 배열 UniqueConstraint 및 열이 기본 키인지 여부를 나타내는 값을 사용하여 새 DataColumn 열을 생성하고 컬렉션에 추가합니다.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);

public System.Data.Constraint Add(string? name, System.Data.DataColumn[] columns, bool primaryKey);

public System.Data.Constraint Add(string name, System.Data.DataColumn[] columns, bool primaryKey);

public virtual System.Data.Constraint Add(string name, System.Data.DataColumn[] columns, bool primaryKey);

member this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint

abstract member Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint

Public Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Public Overridable Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

매개 변수

name: String

UniqueConstraint의 이름입니다.

columns: DataColumn[]

제약 조건이 적용되는 개체의 DataColumn 배열입니다.

primaryKey: Boolean

열이 기본 키여야 하는지 여부를 지정합니다. 이 경우 true열은 기본 키 열이 됩니다.

반품

Constraint

새 UniqueConstraint.

예외

ArgumentException

제약 조건이 이미 이 컬렉션에 속합니다.

-또는-

제약 조건은 다른 컬렉션에 속합니다.

DuplicateNameException

컬렉션에 이미 지정된 이름의 제약 조건이 있습니다. (비교는 대/소문자를 구분하지 않습니다.)

예제

다음 예제에서는 특정DataColumn에서 새 UniqueConstraint 개체를 만드는 데 사용되는 개체의 DataTable 배열을 만듭니다.

private void AddUniqueConstraint(DataTable table)
{
    DataColumn[] columns = new DataColumn[1];
    columns[0] = table.Columns["ID"];
    columns[1] = table.Columns["Name"];
    table.Constraints.Add("idNameConstraint", columns, true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    Dim columns(1) As DataColumn
    columns(0) = table.Columns("ID")
    columns(1) = table.Columns("Name")
    table.Constraints.Add("idNameConstraint", columns, True)
End Sub

설명

제약 CollectionChanged 조건이 성공적으로 추가되면 이벤트가 발생합니다.

추가 정보

UniqueConstraint

적용 대상

Add(String, DataColumn[], DataColumn[])

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

Source:: ConstraintCollection.cs

부모 열 및 자식 열의 지정된 배열을 사용하여 새 ForeignKeyConstraint열을 생성하고 컬렉션에 제약 조건을 추가합니다.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public:
 virtual System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public System.Data.Constraint Add(string? name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

public System.Data.Constraint Add(string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

public virtual System.Data.Constraint Add(string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

member this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint

abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint

Public Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Public Overridable Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

매개 변수

name: String

ForeignKeyConstraint의 이름입니다.

primaryKeyColumns: DataColumn[]

기본 키 또는 부모 열인 개체의 배열 DataColumn 입니다.

foreignKeyColumns: DataColumn[]

외래 키 또는 자식 열인 개체의 DataColumn 배열입니다.

반품

Constraint

새 ForeignKeyConstraint.

예제

다음 예제에서는 두 개의 개체 배열을 만든 다음 데이터 세트의 DataColumn 두 테이블 간에 두 ForeignKeyConstraint 개의 관계를 만듭니다.

private void AddForeignConstraint(
    DataSet dataSet, DataTable table)
{
    try
    {
        DataColumn[] parentColumns = new DataColumn[2];
        DataColumn[] childColumns = new DataColumn[2];
        // Get the tables from the DataSet.
        DataTable customersTable = dataSet.Tables["Customers"];
        DataTable ordersTable = dataSet.Tables["Orders"];

        // Set Columns.
        parentColumns[0]=customersTable.Columns["id"];
        parentColumns[1]=customersTable.Columns["Name"];
        childColumns[0] = ordersTable.Columns["CustomerID"];
        childColumns[1] = ordersTable.Columns["CustomerName"];

        // Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint",
            parentColumns, childColumns);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint( _
ByVal dataSet As DataSet, ByVal table As DataTable)
    Try
        Dim parentColumns(1) As DataColumn
        Dim childColumns(1) As DataColumn
        ' Get the tables from the DataSet.
        Dim customersTable As DataTable = _
            dataSet.Tables("Customers")
        Dim ordersTable As DataTable = _
            dataSet.Tables("Orders")

        ' Set Columns.
        parentColumns(0) = customersTable.Columns("id")
        parentColumns(1) = customersTable.Columns("Name")
        childColumns(0) = ordersTable.Columns("CustomerID")
        childColumns(1) = ordersTable.Columns("CustomerName")

        ' Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint", _
            parentColumns, childColumns)

    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

설명

제약 CollectionChanged 조건이 성공적으로 추가되면 이벤트가 발생합니다.

적용 대상

피드백

이 페이지가 도움이 되었나요?