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


DataRelationCollection.Add Метод

Определение

Добавляет объект DataRelation в коллекцию DataRelationCollection.

Перегрузки

Add(DataRelation)

Добавляет объект DataRelation в коллекцию DataRelationCollection.

Add(DataColumn, DataColumn)

Создает DataRelation с указанными родительским и дочерним столбцами и добавляет их к коллекции.

Add(DataColumn[], DataColumn[])

Создает DataRelation с указанными родительским и дочерним столбцами и добавляет их к коллекции.

Add(String, DataColumn, DataColumn)

Создает отношение DataRelation с указанным именем и родительским и дочерним столбцами и добавляет их к коллекции.

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

Создает DataRelation с указанным именем и массивами родительских и дочерних столбцов и добавляет их к коллекции.

Add(String, DataColumn, DataColumn, Boolean)

Создает отношение DataRelation с указанным именем, родительскими и дочерними столбцами, с необязательными ограничениями в соответствии со значением параметра createConstraints, затем добавляет это отношение в коллекцию.

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

Создает DataRelation с указанным именем, массивами родительских и дочерних столбцов и значение, указывающее, создавать ли ограничения, и добавляет их к коллекции.

Add(DataRelation)

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

Добавляет объект DataRelation в коллекцию DataRelationCollection.

public:
 void Add(System::Data::DataRelation ^ relation);
public void Add (System.Data.DataRelation relation);
member this.Add : System.Data.DataRelation -> unit
Public Sub Add (relation As DataRelation)

Параметры

relation
DataRelation

Параметр DataRelation для добавления в коллекцию.

Исключения

Параметр relation имеет нулевое значение.

Соотношение уже принадлежит данной коллекции, или оно принадлежит другой коллекции.

Коллекция уже содержит отношение с указанным именем. (Сравнение выполняется без учета регистра).

Отношение перешло в недопустимое состояние со времени создания.

Комментарии

Если отношение успешно добавлено в коллекцию, CollectionChanged происходит событие .

DataRelation Когда объект добавляется в коллекцию, и UniqueConstraint объекты создаются по умолчанию, ForeignKeyConstraint если они еще не существуют.

См. также раздел

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

Add(DataColumn, DataColumn)

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

Создает DataRelation с указанными родительским и дочерним столбцами и добавляет их к коллекции.

public:
 virtual System::Data::DataRelation ^ Add(System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public virtual System.Data.DataRelation Add (System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
abstract member Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
Public Overridable Function Add (parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

Параметры

parentColumn
DataColumn

Родительский столбец отношения.

childColumn
DataColumn

Дочерний столбец отношения.

Возвращаемое значение

Созданное соотношение.

Комментарии

DataRelation Когда объект добавляется в коллекцию, и UniqueConstraint объекты создаются по умолчанию, ForeignKeyConstraint если они еще не существуют.

См. также раздел

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

Add(DataColumn[], DataColumn[])

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

Создает DataRelation с указанными родительским и дочерним столбцами и добавляет их к коллекции.

public:
 virtual System::Data::DataRelation ^ Add(cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public virtual System.Data.DataRelation Add (System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
abstract member Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
Public Overridable Function Add (parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

Параметры

parentColumns
DataColumn[]

Родительские столбцы отношения.

childColumns
DataColumn[]

Дочерние столбцы отношения.

Возвращаемое значение

Созданное соотношение.

Исключения

Аргумент relation имеет значение null.

Соотношение уже принадлежит данной коллекции, или оно принадлежит другой коллекции.

Коллекция уже содержит отношение с тем же именем. (Сравнение выполняется без учета регистра).

Отношение перешло в недопустимое состояние со времени создания.

Комментарии

DataRelation Когда объект добавляется в коллекцию, и UniqueConstraint объекты создаются по умолчанию, ForeignKeyConstraint если они еще не существуют.

См. также раздел

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

Add(String, DataColumn, DataColumn)

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

Создает отношение DataRelation с указанным именем и родительским и дочерним столбцами и добавляет их к коллекции.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

Параметры

name
String

Имя отношения.

parentColumn
DataColumn

Родительский столбец отношения.

childColumn
DataColumn

Дочерний столбец отношения.

Возвращаемое значение

Созданное соотношение.

Комментарии

DataRelation Когда объект добавляется в коллекцию, и UniqueConstraint объекты создаются по умолчанию, ForeignKeyConstraint если они еще не существуют.

См. также раздел

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

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

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

Создает DataRelation с указанным именем и массивами родительских и дочерних столбцов и добавляет их к коллекции.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

Параметры

name
String

Имя создаваемого элемента DataRelation.

parentColumns
DataColumn[]

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

childColumns
DataColumn[]

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

Возвращаемое значение

Созданный DataRelation.

Исключения

Имя отношения имеет нулевое значение.

Соотношение уже принадлежит данной коллекции, или оно принадлежит другой коллекции.

Коллекция уже содержит отношение с тем же именем. (Сравнение выполняется без учета регистра).

Отношение перешло в недопустимое состояние со времени создания.

Примеры

private void AddRelation()
{
    DataTable table = new DataTable();
    DataColumn column1 = table.Columns.Add("Column1");
    DataColumn column2 = table.Columns.Add("Column2");
    table.ChildRelations.Add("New Relation", column1, column2);
}
Private Sub AddRelation()
    Dim table As New DataTable()
    Dim column1 As DataColumn = table.Columns.Add("Column1")
    Dim column2 As DataColumn = table.Columns.Add("Column2")
    table.ChildRelations.Add("New Relation", column1, column2)
End Sub

Комментарии

Если отношение успешно добавлено в коллекцию, CollectionChanged происходит событие .

DataRelation Когда объект добавляется в коллекцию, и UniqueConstraint объекты создаются по умолчанию, ForeignKeyConstraint если они еще не существуют.

См. также раздел

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

Add(String, DataColumn, DataColumn, Boolean)

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

Создает отношение DataRelation с указанным именем, родительскими и дочерними столбцами, с необязательными ограничениями в соответствии со значением параметра createConstraints, затем добавляет это отношение в коллекцию.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);
public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean) As DataRelation

Параметры

name
String

Имя отношения.

parentColumn
DataColumn

Родительский столбец отношения.

childColumn
DataColumn

Дочерний столбец отношения.

createConstraints
Boolean

true для создания ограничений; в противном случае — false. (Значением по умолчанию является true).

Возвращаемое значение

Созданное соотношение.

Комментарии

DataRelation Когда объект добавляется в коллекцию, и UniqueConstraint объекты создаются по умолчанию, ForeignKeyConstraint если они еще не существуют. Чтобы избежать этого, можно задать для параметра createConstraints значение false.

См. также раздел

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

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

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

Создает DataRelation с указанным именем, массивами родительских и дочерних столбцов и значение, указывающее, создавать ли ограничения, и добавляет их к коллекции.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);
public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean) As DataRelation

Параметры

name
String

Имя создаваемого элемента DataRelation.

parentColumns
DataColumn[]

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

childColumns
DataColumn[]

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

createConstraints
Boolean

true для создания ограничения; в противном случае — false.

Возвращаемое значение

Созданное соотношение.

Исключения

Имя отношения имеет нулевое значение.

Соотношение уже принадлежит данной коллекции, или оно принадлежит другой коллекции.

Коллекция уже содержит отношение с тем же именем. (Сравнение выполняется без учета регистра).

Отношение перешло в недопустимое состояние со времени создания.

Комментарии

DataRelation Когда объект добавляется в коллекцию, и UniqueConstraint объекты создаются по умолчанию, ForeignKeyConstraint если они еще не существуют.

См. также раздел

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