ConstraintCollection.Add Yöntem

Başvuru

Tanım

Ad Alanı:: System.Data

Bütünleştirilmiş Kod:: System.Data.Common.dll

Bütünleştirilmiş Kod:: System.Data.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Koleksiyona bir Constraint nesne ekler.

Aşırı Yüklemeler

Add(Constraint)	Belirtilen Constraint nesneyi koleksiyona ekler.
Add(String, DataColumn, Boolean)	Sütunun birincil anahtar olup olmadığını gösteren belirtilen ad, DataColumnve değeriyle yeni UniqueConstraint bir oluşturur ve bunu koleksiyona ekler.
Add(String, DataColumn, DataColumn)	Belirtilen ad, üst sütun ve alt sütun ile yeni ForeignKeyConstraint bir oluşturur ve kısıtlamayı koleksiyona ekler.
Add(String, DataColumn[], Boolean)	Belirtilen ad, nesne dizisi ve sütunun DataColumn birincil anahtar olup olmadığını gösteren değerle yeni UniqueConstraint bir oluşturur ve bunu koleksiyona ekler.
Add(String, DataColumn[], DataColumn[])	Belirtilen üst sütun ve alt sütun dizileriyle yeni ForeignKeyConstraintbir oluşturur ve kısıtlamayı koleksiyona ekler.

Add(Constraint)

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Belirtilen Constraint nesneyi koleksiyona ekler.

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)

Parametreler

constraint: Constraint

Constraint Eklenecek.

Özel durumlar

ArgumentNullException

Bağımsız constraint değişken null.

ArgumentException

Kısıtlama zaten bu koleksiyona ait veya başka bir koleksiyona ait.

DuplicateNameException

Koleksiyonun zaten aynı ada sahip bir kısıtlaması var. (Karşılaştırma büyük/küçük harfe duyarlı değildir.)

Örnekler

Aşağıdaki örnek, öğesine bir UniqueConstraint ConstraintCollection DataTableekler.

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

Açıklamalar

Kısıtlamalar eklenerek veya kaldırılarak koleksiyon başarıyla değiştirilirse, CollectionChanged olay gerçekleşir.

Ayrıca bkz.

Şunlara uygulanır

Add(String, DataColumn, Boolean)

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Sütunun birincil anahtar olup olmadığını gösteren belirtilen ad, DataColumnve değeriyle yeni UniqueConstraint bir oluşturur ve bunu koleksiyona ekler.

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

Parametreler

name: String

UniqueConstraint öğesinin adı.

column: DataColumn

DataColumn Kısıtlamanın geçerli olduğu.

primaryKey: Boolean

Sütunun birincil anahtar olup olmayacağını belirtir. ise true, sütun birincil anahtar sütunu olur.

Döndürülenler

Constraint

Yeni UniqueConstraintbir .

Özel durumlar

ArgumentException

Kısıtlama zaten bu koleksiyona ait.

-Veya-

Kısıtlama başka bir koleksiyona ait.

DuplicateNameException

Koleksiyonun zaten belirtilen ada sahip bir kısıtlaması var. (Karşılaştırma büyük/küçük harfe duyarlı değildir.)

Örnekler

Aşağıdaki örnek, oluşturmak ve öğesine yeni UniqueConstraint bir eklemek için ConstraintCollectionyöntemini kullanırAdd.

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

Açıklamalar

Kısıtlama CollectionChanged başarıyla eklenirse olay gerçekleşir.

Ayrıca bkz.

UniqueConstraint

Şunlara uygulanır

Add(String, DataColumn, DataColumn)

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Belirtilen ad, üst sütun ve alt sütun ile yeni ForeignKeyConstraint bir oluşturur ve kısıtlamayı koleksiyona ekler.

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

Parametreler

name: String

ForeignKeyConstraint öğesinin adı.

primaryKeyColumn: DataColumn

Birincil anahtar veya üst anahtar DataColumn.

foreignKeyColumn: DataColumn

Yabancı anahtar veya alt anahtar DataColumn.

Döndürülenler

Constraint

Yeni ForeignKeyConstraintbir .

Örnekler

Aşağıdaki örnek, öğesine yeni ForeignKeyConstraint ConstraintCollection bir DataTableekler.

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

Açıklamalar

Kısıtlama CollectionChanged başarıyla eklenirse olay gerçekleşir.

Şunlara uygulanır

Add(String, DataColumn[], Boolean)

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Belirtilen ad, nesne dizisi ve sütunun DataColumn birincil anahtar olup olmadığını gösteren değerle yeni UniqueConstraint bir oluşturur ve bunu koleksiyona ekler.

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

Parametreler

name: String

UniqueConstraint öğesinin adı.

columns: DataColumn[]

Kısıtlamanın DataColumn uygulandığı nesne dizisi.

primaryKey: Boolean

Sütunun birincil anahtar olup olmayacağını belirtir. ise true, sütun birincil anahtar sütunu olur.

Döndürülenler

Constraint

Yeni UniqueConstraintbir .

Özel durumlar

ArgumentException

Kısıtlama zaten bu koleksiyona ait.

-Veya-

Kısıtlama başka bir koleksiyona ait.

DuplicateNameException

Koleksiyonun zaten belirtilen ada sahip bir kısıtlaması var. (Karşılaştırma büyük/küçük harfe duyarlı değildir.)

Örnekler

Aşağıdaki örnek, belirli DataTablebir içinde yeni UniqueConstraint oluşturmak için kullanılan bir nesne dizisi DataColumn oluşturur.

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

Açıklamalar

Kısıtlama CollectionChanged başarıyla eklenirse olay gerçekleşir.

Ayrıca bkz.

UniqueConstraint

Şunlara uygulanır

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

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Kaynak:: ConstraintCollection.cs

Belirtilen üst sütun ve alt sütun dizileriyle yeni ForeignKeyConstraintbir oluşturur ve kısıtlamayı koleksiyona ekler.

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

Parametreler

name: String

ForeignKeyConstraint öğesinin adı.

primaryKeyColumns: DataColumn[]

Birincil anahtar veya üst sütun olan bir nesne dizisi DataColumn .

foreignKeyColumns: DataColumn[]

Yabancı anahtar veya alt sütun olan nesne dizisi DataColumn .

Döndürülenler

Constraint

Yeni ForeignKeyConstraintbir .

Örnekler

Aşağıdaki örnek iki nesne dizisi DataColumn oluşturur ve ardından bir veri kümesindeki iki tablo arasında iki ForeignKeyConstraint ilişki oluşturur.

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

Açıklamalar

Kısıtlama CollectionChanged başarıyla eklenirse olay gerçekleşir.

Şunlara uygulanır

Share via

ConstraintCollection.Add Yöntem

Tanım

Aşırı Yüklemeler

Add(Constraint)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(String, DataColumn, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(String, DataColumn, DataColumn)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Şunlara uygulanır

Add(String, DataColumn[], Boolean)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar