Поделиться через


ForeignKeyConstraint Конструкторы

Определение

Инициализирует новый экземпляр класса ForeignKeyConstraint.

Перегрузки

ForeignKeyConstraint(DataColumn, DataColumn)

Инициализирует новый экземпляр класса ForeignKeyConstraint с указанным родительским и дочерним объектами DataColumn.

ForeignKeyConstraint(DataColumn[], DataColumn[])

Инициализирует новый экземпляр класса ForeignKeyConstraint указанным родительским и дочерним объектами DataColumn.

ForeignKeyConstraint(String, DataColumn, DataColumn)

Инициализирует новый экземпляр класса ForeignKeyConstraint с указанным именем и родительским и дочерним объектами DataColumn.

ForeignKeyConstraint(String, DataColumn[], DataColumn[])

Инициализирует новый экземпляр класса ForeignKeyConstraint с указанным именем и массивами родительских и дочерних объектов DataColumn.

ForeignKeyConstraint(String, String, String[], String[], AcceptRejectRule, Rule, Rule)

Этот конструктор предназначен для поддержки режима разработки в среде Visual Studio. Объекты ForeignKeyConstraint, созданные с помощью этого конструктора, должны затем добавляться в коллекцию при помощи метода AddRange(Constraint[]). Таблицы и столбцы с указанными именами должны существовать во время вызова метода; если же метод BeginInit() был вызван до вызова этого конструктора, таблицы и столбцы с указанными именами должны существовать во время вызова метода EndInit().

ForeignKeyConstraint(String, String, String, String[], String[], AcceptRejectRule, Rule, Rule)

Этот конструктор предназначен для поддержки режима разработки в среде Visual Studio. Объекты ForeignKeyConstraint, созданные с помощью этого конструктора, должны затем добавляться в коллекцию при помощи метода AddRange(Constraint[]). Таблицы и столбцы с указанными именами должны существовать во время вызова метода; если же метод BeginInit() был вызван до вызова этого конструктора, таблицы и столбцы с указанными именами должны существовать во время вызова метода EndInit().

ForeignKeyConstraint(DataColumn, DataColumn)

Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs

Инициализирует новый экземпляр класса ForeignKeyConstraint с указанным родительским и дочерним объектами DataColumn.

public:
 ForeignKeyConstraint(System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public ForeignKeyConstraint (System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
new System.Data.ForeignKeyConstraint : System.Data.DataColumn * System.Data.DataColumn -> System.Data.ForeignKeyConstraint
Public Sub New (parentColumn As DataColumn, childColumn As DataColumn)

Параметры

parentColumn
DataColumn

Родительский объект DataColumn в ограничении.

childColumn
DataColumn

Дочерний объект DataColumn в ограничении.

Исключения

Значением одного или обоих столбцов является null.

Столбцы имеют различные типы данных.

Или

Таблицы не принадлежат одному и тому же объекту DataSet.

Примеры

В следующем примере создается новый ForeignKeyConstraintобъект , устанавливаются некоторые из его свойств и добавляются в DataTable объект ConstraintCollection.

' The next line goes into the Declarations section.
' SuppliersProducts is a class derived from DataSet.
Private suppliersProducts As SuppliersProducts 
 
Private Sub CreateConstraint()
   ' Declare parent column and child column variables.
   Dim parentColumn As DataColumn
   Dim childColumn As DataColumn
   Dim fkConstraint As ForeignKeyConstraint

   ' Set parent and child column variables.
   parentColumn = _
       suppliersProducts.Tables("Suppliers").Columns("SupplierID")
   childColumn = _
       suppliersProducts.Tables("Products").Columns("SupplieriD")
   fkConstraint = New ForeignKeyConstraint(parentColumn, childColumn)

   ' Set various properties of the constraint.
   With fkConstraint
      .ConstraintName = "suppierFKConstraint"
      .DeleteRule = Rule.SetNull
      .UpdateRule = Rule.Cascade
      .AcceptRejectRule = AcceptRejectRule.Cascade
   End With

   ' Add the constraint, and set EnforceConstraints to true.
   suppliersProducts.Tables("Products").Constraints.Add(fkConstraint)
   suppliersProducts.EnforceConstraints = True
End Sub

Применяется к

ForeignKeyConstraint(DataColumn[], DataColumn[])

Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs

Инициализирует новый экземпляр класса ForeignKeyConstraint указанным родительским и дочерним объектами DataColumn.

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

Параметры

parentColumns
DataColumn[]

Массив родительских объектов DataColumn в ограничении.

childColumns
DataColumn[]

Массив дочерних объектов DataColumn в ограничении.

Исключения

Значением одного или обоих столбцов является null.

Столбцы имеют различные типы данных.

Или

Таблицы не принадлежат одному и тому же объекту DataSet.

Примеры

В следующем примере создается новый ForeignKeyConstraintобъект , устанавливаются некоторые из его свойств и добавляются в DataTable объект ConstraintCollection.

' The next line goes into the Declarations section.
' SuppliersProducts is a class derived from DataSet.
Private suppliersProducts As SuppliersProducts

Private Sub CreateConstraint()
   ' Declare parent column and child column variables.
   Dim parentColumns(1) As DataColumn
   Dim childColumns(1) As DataColumn
   Dim fkConstraint As ForeignKeyConstraint

   ' Set parent and child column variables.
   parentColumns(0) = _
       suppliersProducts.Tables("OrderDetails").Columns("OrderID")
   parentColumns(1) = _
       suppliersProducts.Tables("OrderDetails").Columns("ProductID")
   childColumns(0) = _
       suppliersProducts.Tables("Sales").Columns("OrderID")
   childColumns(1) = _
       suppliersProducts.Tables("Sales").Columns("ProductID")
   fkConstraint = _
       New ForeignKeyConstraint(parentColumns, childColumns)

   ' Set various properties of the constraint.
   With fkConstraint
      .ConstraintName = "ProductSalesOrders"
      .DeleteRule = Rule.SetDefault
      .UpdateRule = Rule.Cascade
      .AcceptRejectRule = AcceptRejectRule.Cascade
   End With

   ' Add the constraint, and set EnforceConstraints to true.
   suppliersProducts.Tables( _
       "OrderDetails").Constraints.Add(fkConstraint)
   suppliersProducts.EnforceConstraints = True
End Sub

Применяется к

ForeignKeyConstraint(String, DataColumn, DataColumn)

Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs

Инициализирует новый экземпляр класса ForeignKeyConstraint с указанным именем и родительским и дочерним объектами DataColumn.

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

Параметры

constraintName
String

Имя ограничения.

parentColumn
DataColumn

Родительский объект DataColumn в ограничении.

childColumn
DataColumn

Дочерний объект DataColumn в ограничении.

Исключения

Значением одного или обоих столбцов является null.

Столбцы имеют различные типы данных.

Или

Таблицы не принадлежат одному и тому же объекту DataSet.

Примеры

В следующем примере создается новый ForeignKeyConstraintобъект , устанавливаются некоторые из его свойств и добавляются в DataTable объект ConstraintCollection.

' The next line goes into the Declarations section of the module:
   ' SuppliersProducts is a class derived from DataSet.
   Private suppliersProducts As SuppliersProducts

Private Sub CreateConstraint()
   ' Declare parent column and child column variables.
   Dim parentColumn As DataColumn
   Dim childColumn As DataColumn
   Dim fkeyConstraint As ForeignKeyConstraint

   ' Set parent and child column variables.
   parentColumn = _
       suppliersProducts.Tables("Suppliers").Columns("SupplierID")
   childColumn = _
       suppliersProducts.Tables("Products").Columns("SupplierID")
   fkeyConstraint = New ForeignKeyConstraint( _
       "SupplierFKConstraint", parentColumn, childColumn)

   ' Set various properties of the constraint.
   With fkeyConstraint
      .DeleteRule = Rule.SetNull
      .UpdateRule = Rule.Cascade
      .AcceptRejectRule = AcceptRejectRule.Cascade
   End With

   ' Add the constraint, and set EnforceConstraints to true.
   suppliersProducts.Tables("Products").Constraints.Add(fkeyConstraint)
   suppliersProducts.EnforceConstraints = True
End Sub

Применяется к

ForeignKeyConstraint(String, DataColumn[], DataColumn[])

Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs

Инициализирует новый экземпляр класса ForeignKeyConstraint с указанным именем и массивами родительских и дочерних объектов DataColumn.

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

Параметры

constraintName
String

Имя ForeignKeyConstraint. Если значением является null или пустая строка, то при добавлении этого ограничения в коллекцию ему будет присвоено имя по умолчанию.

parentColumns
DataColumn[]

Массив родительских объектов DataColumn в ограничении.

childColumns
DataColumn[]

Массив дочерних объектов DataColumn в ограничении.

Исключения

Значением одного или обоих столбцов является null.

Столбцы имеют различные типы данных.

Или

Таблицы не принадлежат одному и тому же объекту DataSet.

Примеры

В следующем примере создается новый ForeignKeyConstraintобъект , устанавливаются некоторые из его свойств и добавляются в DataTable объект ConstraintCollection.

Private Sub CreateConstraint(ByVal suppliersProducts As DataSet)
    ' Declare parent column and child column variables.
    Dim parentColumns(1) As DataColumn
    Dim childColumns(1) As DataColumn
    Dim fkConstraint As ForeignKeyConstraint

    ' Set parent and child column variables.
    parentColumns(0) = _
        suppliersProducts.Tables("OrderDetails").Columns("OrderID")
    parentColumns(1) = _
        suppliersProducts.Tables("OrderDetails").Columns("ProductID")
    childColumns(0) = _
        suppliersProducts.Tables("Sales").Columns("OrderID")
    childColumns(1) = _
        suppliersProducts.Tables("Sales").Columns("ProductID")
    fkConstraint = New ForeignKeyConstraint( _
        "ProductSalesOrders", parentColumns, childColumns)

    ' Set various properties of the constraint.
    With fkConstraint
        .DeleteRule = Rule.SetDefault
        .UpdateRule = Rule.Cascade
        .AcceptRejectRule = AcceptRejectRule.Cascade
    End With

    ' Add the constraint, and set EnforceConstraints to true.
    suppliersProducts.Tables("OrderDetails").Constraints.Add( _
        fkConstraint)
    suppliersProducts.EnforceConstraints = True
End Sub

Применяется к

ForeignKeyConstraint(String, String, String[], String[], AcceptRejectRule, Rule, Rule)

Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs

Этот конструктор предназначен для поддержки режима разработки в среде Visual Studio. Объекты ForeignKeyConstraint, созданные с помощью этого конструктора, должны затем добавляться в коллекцию при помощи метода AddRange(Constraint[]). Таблицы и столбцы с указанными именами должны существовать во время вызова метода; если же метод BeginInit() был вызван до вызова этого конструктора, таблицы и столбцы с указанными именами должны существовать во время вызова метода EndInit().

public:
 ForeignKeyConstraint(System::String ^ constraintName, System::String ^ parentTableName, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, System::Data::AcceptRejectRule acceptRejectRule, System::Data::Rule deleteRule, System::Data::Rule updateRule);
[System.ComponentModel.Browsable(false)]
public ForeignKeyConstraint (string? constraintName, string? parentTableName, string[] parentColumnNames, string[] childColumnNames, System.Data.AcceptRejectRule acceptRejectRule, System.Data.Rule deleteRule, System.Data.Rule updateRule);
[System.ComponentModel.Browsable(false)]
public ForeignKeyConstraint (string constraintName, string parentTableName, string[] parentColumnNames, string[] childColumnNames, System.Data.AcceptRejectRule acceptRejectRule, System.Data.Rule deleteRule, System.Data.Rule updateRule);
[<System.ComponentModel.Browsable(false)>]
new System.Data.ForeignKeyConstraint : string * string * string[] * string[] * System.Data.AcceptRejectRule * System.Data.Rule * System.Data.Rule -> System.Data.ForeignKeyConstraint
Public Sub New (constraintName As String, parentTableName As String, parentColumnNames As String(), childColumnNames As String(), acceptRejectRule As AcceptRejectRule, deleteRule As Rule, updateRule As Rule)

Параметры

constraintName
String

Имя ограничения.

parentTableName
String

Имя родительского объекта DataTable, который содержит родительские объекты DataColumn в ограничении.

parentColumnNames
String[]

Массив имен родительских объектов DataColumn в ограничении.

childColumnNames
String[]

Массив имен дочерних объектов DataColumn в ограничении.

acceptRejectRule
AcceptRejectRule

Одно из значений перечисления AcceptRejectRule. Возможными значениями являются None, Cascade и Default.

deleteRule
Rule

Одно из значений Rule, используемое при удалении строки. Значение по умолчанию — Cascade. Возможными значениями являются None, Cascade, SetNull, SetDefault и Default.

updateRule
Rule

Одно из значений Rule, используемое при обновлении строки. Значение по умолчанию — Cascade. Возможными значениями являются None, Cascade, SetNull, SetDefault и Default.

Атрибуты

Исключения

Значением одного или обоих столбцов является null.

Столбцы имеют различные типы данных.

Или

Таблицы не принадлежат одному и тому же объекту DataSet.

Применяется к

ForeignKeyConstraint(String, String, String, String[], String[], AcceptRejectRule, Rule, Rule)

Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs
Исходный код:
ForeignKeyConstraint.cs

Этот конструктор предназначен для поддержки режима разработки в среде Visual Studio. Объекты ForeignKeyConstraint, созданные с помощью этого конструктора, должны затем добавляться в коллекцию при помощи метода AddRange(Constraint[]). Таблицы и столбцы с указанными именами должны существовать во время вызова метода; если же метод BeginInit() был вызван до вызова этого конструктора, таблицы и столбцы с указанными именами должны существовать во время вызова метода EndInit().

public:
 ForeignKeyConstraint(System::String ^ constraintName, System::String ^ parentTableName, System::String ^ parentTableNamespace, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, System::Data::AcceptRejectRule acceptRejectRule, System::Data::Rule deleteRule, System::Data::Rule updateRule);
[System.ComponentModel.Browsable(false)]
public ForeignKeyConstraint (string? constraintName, string? parentTableName, string? parentTableNamespace, string[] parentColumnNames, string[] childColumnNames, System.Data.AcceptRejectRule acceptRejectRule, System.Data.Rule deleteRule, System.Data.Rule updateRule);
[System.ComponentModel.Browsable(false)]
public ForeignKeyConstraint (string constraintName, string parentTableName, string parentTableNamespace, string[] parentColumnNames, string[] childColumnNames, System.Data.AcceptRejectRule acceptRejectRule, System.Data.Rule deleteRule, System.Data.Rule updateRule);
[<System.ComponentModel.Browsable(false)>]
new System.Data.ForeignKeyConstraint : string * string * string * string[] * string[] * System.Data.AcceptRejectRule * System.Data.Rule * System.Data.Rule -> System.Data.ForeignKeyConstraint
Public Sub New (constraintName As String, parentTableName As String, parentTableNamespace As String, parentColumnNames As String(), childColumnNames As String(), acceptRejectRule As AcceptRejectRule, deleteRule As Rule, updateRule As Rule)

Параметры

constraintName
String

Имя ограничения.

parentTableName
String

Имя родительского объекта DataTable, который содержит родительские объекты DataColumn в ограничении.

parentTableNamespace
String

Имя Namespace.

parentColumnNames
String[]

Массив имен родительских объектов DataColumn в ограничении.

childColumnNames
String[]

Массив имен дочерних объектов DataColumn в ограничении.

acceptRejectRule
AcceptRejectRule

Одно из значений перечисления AcceptRejectRule. Возможными значениями являются None, Cascade и Default.

deleteRule
Rule

Одно из значений Rule, используемое при удалении строки. Значение по умолчанию — Cascade. Возможными значениями являются None, Cascade, SetNull, SetDefault и Default.

updateRule
Rule

Одно из значений Rule, используемое при обновлении строки. Значение по умолчанию — Cascade. Возможными значениями являются None, Cascade, SetNull, SetDefault и Default.

Атрибуты

Исключения

Значением одного или обоих столбцов является null.

Столбцы имеют различные типы данных.

Или

Таблицы не принадлежат одному и тому же объекту DataSet.

Применяется к