DataRelationCollection.Add Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Добавляет объект 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

Добавляет объект 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 для добавления в коллекцию.

Исключения

ArgumentNullException

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

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

Комментарии

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

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

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

• Добавление отношений DataRelation
• Навигация по отношениям DataRelation

Add(DataColumn, DataColumn)

Исходный код:

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

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

Комментарии

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

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

• Добавление отношений DataRelation
• Навигация по отношениям DataRelation

Add(DataColumn[], DataColumn[])

Исходный код:

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[]

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

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

DataRelation

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

Исключения

ArgumentNullException

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

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

Комментарии

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

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

• Добавление отношений DataRelation
• Навигация по отношениям DataRelation

Add(String, DataColumn, DataColumn)

Исходный код:

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);

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

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

Комментарии

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

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

• Добавление отношений DataRelation
• Навигация по отношениям DataRelation

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

Исходный код:

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);

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

Созданный DataRelation.

Исключения

ArgumentNullException

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

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

Примеры

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 если они еще не существуют.

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

• Добавление отношений DataRelation
• Навигация по отношениям DataRelation

Add(String, DataColumn, DataColumn, Boolean)

Исходный код:

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);

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

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

Комментарии

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

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

• Добавление отношений DataRelation
• Навигация по отношениям DataRelation

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

Исходный код:

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);

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

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

Исключения

ArgumentNullException

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

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

Комментарии

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

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

• Добавление отношений DataRelation
• Навигация по отношениям DataRelation