DataRelationCollection.Add Метод

Определение

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

Перегрузки

Add(DataRelation)

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

Add(DataColumn, DataColumn)

Создает DataRelation с указанными родительским и дочерним столбцами и добавляет их к коллекции.Creates a DataRelation with a specified parent and child column, and adds it to the collection.

Add(DataColumn[], DataColumn[])

Создает DataRelation с указанными родительским и дочерним столбцами и добавляет их к коллекции.Creates a DataRelation with the specified parent and child columns, and adds it to the collection.

Add(String, DataColumn, DataColumn)

Создает отношение DataRelation с указанным именем и родительским и дочерним столбцами и добавляет их к коллекции.Creates a DataRelation with the specified name, and parent and child columns, and adds it to the collection.

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

Создает DataRelation с указанным именем и массивами родительских и дочерних столбцов и добавляет их к коллекции.Creates a DataRelation with the specified name and arrays of parent and child columns, and adds it to the collection.

Add(String, DataColumn, DataColumn, Boolean)

Создает отношение DataRelation с указанным именем, родительскими и дочерними столбцами, с необязательными ограничениями в соответствии со значением параметра createConstraints, затем добавляет это отношение в коллекцию.Creates a DataRelation with the specified name, parent and child columns, with optional constraints according to the value of the createConstraints parameter, and adds it to the collection.

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

Создает DataRelation с указанным именем, массивами родительских и дочерних столбцов и значение, указывающее, создавать ли ограничения, и добавляет их к коллекции.Creates a DataRelation with the specified name, arrays of parent and child columns, and value specifying whether to create a constraint, and adds it to the collection.

Add(DataRelation)

Добавляет объект DataRelation в коллекцию DataRelationCollection.Adds a DataRelation to the 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, добавляемый в коллекцию.The DataRelation to add to the collection.

Исключения

Параметр relation имеет нулевое значение.The relation parameter is a null value.

Соотношение уже принадлежит данной коллекции, или оно принадлежит другой коллекции.The relation already belongs to this collection, or it belongs to another collection.

Коллекция уже содержит отношение с указанным именем.The collection already has a relation with the specified name. (Сравнение выполняется без учета регистра).(The comparison is not case sensitive.)

Отношение перешло в недопустимое состояние со времени создания.The relation has entered an invalid state since it was created.

Комментарии

Если отношение успешно добавлено в коллекцию, возникает событие CollectionChanged.If the relation is successfully added to the collection, the CollectionChanged event occurs.

При добавлении DataRelation объекта в коллекцию объекты ForeignKeyConstraint и UniqueConstraint создаются по умолчанию, если они еще не существуют.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Дополнительно

Add(DataColumn, DataColumn)

Создает DataRelation с указанными родительским и дочерним столбцами и добавляет их к коллекции.Creates a DataRelation with a specified parent and child column, and adds it to the collection.

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

Родительский столбец отношения.The parent column of the relation.

childColumn
DataColumn

Дочерний столбец отношения.The child column of the relation.

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

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

Комментарии

При добавлении DataRelation объекта в коллекцию объекты ForeignKeyConstraint и UniqueConstraint создаются по умолчанию, если они еще не существуют.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Дополнительно

Add(DataColumn[], DataColumn[])

Создает DataRelation с указанными родительским и дочерним столбцами и добавляет их к коллекции.Creates a DataRelation with the specified parent and child columns, and adds it to the collection.

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

Родительские столбцы отношения.The parent columns of the relation.

childColumns
DataColumn[]

Дочерние столбцы отношения.The child columns of the relation.

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

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

Исключения

Аргумент relation имеет значение null.The relation argument is a null value.

Соотношение уже принадлежит данной коллекции, или оно принадлежит другой коллекции.The relation already belongs to this collection, or it belongs to another collection.

Коллекция уже содержит отношение с тем же именем.The collection already has a relation with the same name. (Сравнение выполняется без учета регистра).(The comparison is not case sensitive.)

Отношение перешло в недопустимое состояние со времени создания.The relation has entered an invalid state since it was created.

Комментарии

При добавлении DataRelation объекта в коллекцию объекты ForeignKeyConstraint и UniqueConstraint создаются по умолчанию, если они еще не существуют.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Дополнительно

Add(String, DataColumn, DataColumn)

Создает отношение DataRelation с указанным именем и родительским и дочерним столбцами и добавляет их к коллекции.Creates a DataRelation with the specified name, and parent and child columns, and adds it to the collection.

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

Имя отношения.The name of the relation.

parentColumn
DataColumn

Родительский столбец отношения.The parent column of the relation.

childColumn
DataColumn

Дочерний столбец отношения.The child column of the relation.

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

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

Комментарии

При добавлении DataRelation объекта в коллекцию объекты ForeignKeyConstraint и UniqueConstraint создаются по умолчанию, если они еще не существуют.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Дополнительно

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

Создает DataRelation с указанным именем и массивами родительских и дочерних столбцов и добавляет их к коллекции.Creates a DataRelation with the specified name and arrays of parent and child columns, and adds it to the collection.

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.The name of the DataRelation to create.

parentColumns
DataColumn[]

Массив родительских объектов DataColumn.An array of parent DataColumn objects.

childColumns
DataColumn[]

Массив дочерних объектов DataColumn.An array of child DataColumn objects.

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

Созданный DataRelation.The created DataRelation.

Исключения

Имя отношения имеет нулевое значение.The relation name is a null value.

Соотношение уже принадлежит данной коллекции, или оно принадлежит другой коллекции.The relation already belongs to this collection, or it belongs to another collection.

Коллекция уже содержит отношение с тем же именем.The collection already has a relation with the same name. (Сравнение выполняется без учета регистра).(The comparison is not case sensitive.)

Отношение перешло в недопустимое состояние со времени создания.The relation has entered an invalid state since it was created.

Примеры

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.If the relation is successfully added to the collection, the CollectionChanged event occurs.

При добавлении DataRelation объекта в коллекцию объекты ForeignKeyConstraint и UniqueConstraint создаются по умолчанию, если они еще не существуют.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Дополнительно

Add(String, DataColumn, DataColumn, Boolean)

Создает отношение DataRelation с указанным именем, родительскими и дочерними столбцами, с необязательными ограничениями в соответствии со значением параметра createConstraints, затем добавляет это отношение в коллекцию.Creates a DataRelation with the specified name, parent and child columns, with optional constraints according to the value of the createConstraints parameter, and adds it to the collection.

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

Имя отношения.The name of the relation.

parentColumn
DataColumn

Родительский столбец отношения.The parent column of the relation.

childColumn
DataColumn

Дочерний столбец отношения.The child column of the relation.

createConstraints
Boolean

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

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

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

Комментарии

При добавлении DataRelation объекта в коллекцию объекты ForeignKeyConstraint и UniqueConstraint создаются по умолчанию, если они еще не существуют.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist. Чтобы избежать этого, можно присвоить параметру createConstraints значение false.To prevent this, you can set createConstraints to false.

Дополнительно

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

Создает DataRelation с указанным именем, массивами родительских и дочерних столбцов и значение, указывающее, создавать ли ограничения, и добавляет их к коллекции.Creates a DataRelation with the specified name, arrays of parent and child columns, and value specifying whether to create a constraint, and adds it to the collection.

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.The name of the DataRelation to create.

parentColumns
DataColumn[]

Массив родительских объектов DataColumn.An array of parent DataColumn objects.

childColumns
DataColumn[]

Массив дочерних объектов DataColumn.An array of child DataColumn objects.

createConstraints
Boolean

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

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

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

Исключения

Имя отношения имеет нулевое значение.The relation name is a null value.

Соотношение уже принадлежит данной коллекции, или оно принадлежит другой коллекции.The relation already belongs to this collection, or it belongs to another collection.

Коллекция уже содержит отношение с тем же именем.The collection already has a relation with the same name. (Сравнение выполняется без учета регистра).(The comparison is not case sensitive.)

Отношение перешло в недопустимое состояние со времени создания.The relation has entered an invalid state since it was created.

Комментарии

При добавлении DataRelation объекта в коллекцию объекты ForeignKeyConstraint и UniqueConstraint создаются по умолчанию, если они еще не существуют.When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

Дополнительно

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