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

Определение

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

Сборки:: netstandard.dll, System.Data.Common.dll

Сборка:: System.Data.Common.dll

Сборка:: System.Data.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

Имя	Описание
DataRelation(String, DataColumn, DataColumn)	Инициализирует новый экземпляр класса с помощью указанного DataRelation имени и родительских DataRelation и дочерних DataColumn объектов.
DataRelation(String, DataColumn[], DataColumn[])	Инициализирует новый экземпляр класса с помощью указанного DataRelation DataRelation имени и сопоставленных массивов родительских и дочерних DataColumn объектов.
DataRelation(String, DataColumn, DataColumn, Boolean)	Инициализирует новый экземпляр DataRelation класса, используя указанное имя, родительские и дочерние DataColumn объекты, а также значение, указывающее, следует ли создавать ограничения.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Инициализирует новый экземпляр класса с помощью указанного DataRelation имени, сопоставленных массивов родительских и дочерних DataColumn объектов, а также значение, указывающее, следует ли создавать ограничения.
DataRelation(String, String, String, String[], String[], Boolean)	Этот конструктор предоставляется для поддержки времени разработки в среде Visual Studio.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Этот конструктор предоставляется для поддержки времени разработки в среде Visual Studio.

DataRelation(String, DataColumn, DataColumn)

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

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

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

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

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

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

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);

public DataRelation(string? relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

public DataRelation(string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation

Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn)

Параметры

relationName: String

Имя DataRelation. Если null или пустая строка (""), имя по умолчанию будет присвоено при добавлении созданного объекта в объект DataRelationCollection.

parentColumn: DataColumn

Родительский DataColumn элемент в связи.

childColumn: DataColumn

Дочерний DataColumn элемент в связи.

Исключения

ArgumentNullException

Один или оба DataColumn объекта содержатся null.

InvalidConstraintException

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

-Или-

Таблицы не относятся к одному и тому же DataSet.

Примеры

В следующем примере создается новый DataRelation объект и добавляется в DataRelationCollection объект DataSet.

private void CreateRelation()
{
    // Code to get the DataSet not shown here.
    // Get the DataColumn objects from two DataTable
    // objects in a DataSet.
    DataColumn[] parentCols = new DataColumn[]
        {DataSet1.Tables["Customers"].Columns["CustID"],
        DataSet1.Tables["Customers"].Columns["OrdID"]};
    DataColumn[] childCols= new DataColumn[]
        {DataSet1.Tables["Orders"].Columns["CustID"],
        DataSet1.Tables["Orders"].Columns["OrdID"]};

    // Create DataRelation.
    DataRelation CustOrderRel = new DataRelation(
        "CustomersOrders", parentCols, childCols);

    // Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel);
}


 Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentCols As DataColumn() = _
        {DataSet1.Tables("Customers").Columns("CustID"), _
        DataSet1.Tables("Customers").Columns("OrdID")}
    Dim childCols As DataColumn() = _
        {DataSet1.Tables("Orders").Columns("CustID"), _
        DataSet1.Tables("Orders").Columns("OrdID")}

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentCols, childCols)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

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

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

DataRelation(String, DataColumn[], DataColumn[])

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

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

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

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

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

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

public:
 DataRelation(System::String ^ relationName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);

public DataRelation(string? relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

public DataRelation(string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation

Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn())

Параметры

relationName: String

Имя отношения. Если null или пустая строка (""), имя по умолчанию будет присвоено при добавлении созданного объекта в объект DataRelationCollection.

parentColumns: DataColumn[]

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

childColumns: DataColumn[]

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

Исключения

ArgumentNullException

Один или оба DataColumn объекта содержатся null.

InvalidConstraintException

Объекты DataColumn имеют разные типы данных

-Или-

Один или оба массива не состоят из отдельных столбцов из одной таблицы.

-Или-

Таблицы не относятся к одному и тому же DataSet.

Примеры

В следующем примере создается новый DataRelation объект и добавляется в DataRelationCollection объект DataSet.

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

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

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

DataRelation(String, DataColumn, DataColumn, Boolean)

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

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

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

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

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

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

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);

public DataRelation(string? relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);

public DataRelation(string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);

new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation

Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean)

Параметры

relationName: String

parentColumn: DataColumn

Родительский элемент DataColumn в связи.

childColumn: DataColumn

Дочерний DataColumn элемент в отношении.

createConstraints: Boolean

Значение, указывающее, создаются ли ограничения. true, если создаются ограничения. В противном случае — false.

Исключения

ArgumentNullException

Один или оба DataColumn объекта содержатся null.

InvalidConstraintException

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

-Или-

Таблицы не относятся к одному и тому же DataSet.

Примеры

В следующем примере создается новый DataRelation объект и добавляется в DataRelationCollection объект DataSet.


 Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumn As DataColumn = DataSet1.Tables( _
        "Customers").Columns("CustID")
    Dim childColumn As DataColumn = _
        DataSet1.Tables("Orders").Columns("CustID")

    ' Create DataRelation.
    Dim bConstraints As Boolean = True
    Dim customerOrdersRelation As DataRelation = _
        New DataRelation("CustomersOrders", _
        parentColumn, childColumn, bConstraints)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(customerOrdersRelation)
End Sub

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

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

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

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

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

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

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

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

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

public:
 DataRelation(System::String ^ relationName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);

public DataRelation(string? relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);

public DataRelation(string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);

new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation

Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean)

Параметры

relationName: String

parentColumns: DataColumn[]

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

childColumns: DataColumn[]

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

createConstraints: Boolean

Значение, указывающее, следует ли создавать ограничения. true, если создаются ограничения. В противном случае — false.

Исключения

ArgumentNullException

Один или оба DataColumn объекта.null

InvalidConstraintException

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

-Или-

Таблицы не относятся к одному и тому же DataSet.

Примеры

В следующем примере создается новый DataRelation объект и добавляется в DataRelationCollection объект DataSet.

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")
 
    Dim bConstraints As Boolean = True
    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns,  _
        bConstraints)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

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

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

DataRelation(String, String, String, String[], String[], Boolean)

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

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

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

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

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

Этот конструктор предоставляется для поддержки времени разработки в среде Visual Studio.

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ childTableName, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);

[System.ComponentModel.Browsable(false)]
public DataRelation(string relationName, string? parentTableName, string? childTableName, string[]? parentColumnNames, string[]? childColumnNames, bool nested);

[System.ComponentModel.Browsable(false)]
public DataRelation(string relationName, string parentTableName, string childTableName, string[] parentColumnNames, string[] childColumnNames, bool nested);

[<System.ComponentModel.Browsable(false)>]
new System.Data.DataRelation : string * string * string * string[] * string[] * bool -> System.Data.DataRelation

Public Sub New (relationName As String, parentTableName As String, childTableName As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

Параметры

relationName: String

parentTableName: String

Имя DataTable родительской таблицы отношения.

childTableName: String

Имя DataTable дочерней таблицы отношения.

parentColumnNames: String[]

Массив DataColumn имен объектов в родительском элементе DataTable отношения.

childColumnNames: String[]

Массив DataColumn имен объектов в дочернем DataTable элементе отношения.

nested: Boolean

Значение, указывающее, вложены ли связи.

Атрибуты: BrowsableAttribute

Любой DataRelation объект, созданный с помощью этого конструктора, должен быть добавлен в коллекцию с методом AddRange внутри BeginInit и EndInit блоком. Если этот конструктор не вызывается между BeginInit и EndInit NullReferenceException произойдет. Кроме того, таблицы и столбцы с указанными именами должны существовать во время вызова конструктора.

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

DataRelation(String, String, String, String, String, String[], String[], Boolean)

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

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

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

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

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

Этот конструктор предоставляется для поддержки времени разработки в среде Visual Studio.

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ parentTableNamespace, System::String ^ childTableName, System::String ^ childTableNamespace, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);

[System.ComponentModel.Browsable(false)]
public DataRelation(string relationName, string? parentTableName, string? parentTableNamespace, string? childTableName, string? childTableNamespace, string[]? parentColumnNames, string[]? childColumnNames, bool nested);

[System.ComponentModel.Browsable(false)]
public DataRelation(string relationName, string parentTableName, string parentTableNamespace, string childTableName, string childTableNamespace, string[] parentColumnNames, string[] childColumnNames, bool nested);

[<System.ComponentModel.Browsable(false)>]
new System.Data.DataRelation : string * string * string * string * string * string[] * string[] * bool -> System.Data.DataRelation

Public Sub New (relationName As String, parentTableName As String, parentTableNamespace As String, childTableName As String, childTableNamespace As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

Параметры

relationName: String

parentTableName: String

Имя DataTable родительской таблицы отношения.

parentTableNamespace: String

Имя родительского пространства имен таблицы.

childTableName: String

Имя DataTable дочерней таблицы отношения.

childTableNamespace: String

Имя дочернего пространства имен таблицы.

parentColumnNames: String[]

Массив DataColumn имен объектов в родительском элементе DataTable отношения.

childColumnNames: String[]

Массив DataColumn имен объектов в дочернем DataTable элементе отношения.

nested: Boolean

Значение, указывающее, вложены ли связи.

Атрибуты: BrowsableAttribute

Затем в коллекцию DataRelationнеобходимо добавить любой AddRange объект, созданный с помощью этого конструктора. Таблицы и столбцы с указанными именами должны существовать во время вызова метода или, если BeginInit он был вызван перед вызовом этого конструктора, таблицы и столбцы с указанными именами должны существовать во время EndInit вызова.

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

Обратная связь

Были ли сведения на этой странице полезными?

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

Определение

Перегрузки

DataRelation(String, DataColumn, DataColumn)

Параметры

Исключения

Примеры

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

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

DataRelation(String, DataColumn[], DataColumn[])

Параметры

Исключения

Примеры

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

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

DataRelation(String, DataColumn, DataColumn, Boolean)

Параметры

Исключения

Примеры

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

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

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

Параметры

Исключения

Примеры

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

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

DataRelation(String, String, String, String[], String[], Boolean)

Параметры

Комментарии

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

DataRelation(String, String, String, String, String, String[], String[], Boolean)

Параметры

Комментарии

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