DataRelationCollection.Add Метод

Определение

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

System.Data

Сборки:

netstandard.dll, 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 Когда объект добавляется в коллекцию, и ForeignKeyConstraint объекты создаются по умолчанию, UniqueConstraint если они еще не существуют.

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

• Добавление DataRelations
• навигация по данным

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 Когда объект добавляется в коллекцию, и ForeignKeyConstraint объекты создаются по умолчанию, UniqueConstraint если они еще не существуют.

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

• Добавление DataRelations
• навигация по данным

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

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

Исключения

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

Комментарии

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

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

• Добавление DataRelations
• навигация по данным

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 Когда объект добавляется в коллекцию, и ForeignKeyConstraint объекты создаются по умолчанию, UniqueConstraint если они еще не существуют.

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

• Добавление DataRelations
• навигация по данным

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

Имя отношения — это значение NULL.

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 Когда объект добавляется в коллекцию, и ForeignKeyConstraint объекты создаются по умолчанию, UniqueConstraint если они еще не существуют.

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

• Добавление DataRelations
• навигация по данным

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

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

• Добавление DataRelations
• навигация по данным

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

Имя отношения — это значение NULL.

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

Комментарии

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

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

• Добавление DataRelations
• навигация по данным