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


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

Определение

Инициализирует новый экземпляр класса 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 с использованием указанного имени 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 в отношении.

Исключения

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

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

-Или-

Таблицы не принадлежат тому же DataSet.

Примеры

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

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 с использованием указанного имени 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.

Исключения

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

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

-Или-

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

-Или-

Таблицы не принадлежат тому же DataSet.

Примеры

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

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 с использованием указанного имени, родительского и дочернего объектов 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

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

parentColumn
DataColumn

Родительский объект DataColumn в отношении.

childColumn
DataColumn

Дочерний объект DataColumn в отношении.

createConstraints
Boolean

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

Исключения

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

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

-Или-

Таблицы не принадлежат тому же DataSet.

Примеры

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


 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 с использованием указанного имени, родительского и дочернего объектов 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

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

parentColumns
DataColumn[]

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

childColumns
DataColumn[]

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

createConstraints
Boolean

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

Исключения

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

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

-Или-

Таблицы не принадлежат тому же DataSet.

Примеры

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

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

Этот конструктор предназначен для поддержки режима разработки в среде 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

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

parentTableName
String

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

childTableName
String

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

parentColumnNames
String[]

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

childColumnNames
String[]

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

nested
Boolean

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

Атрибуты

Комментарии

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

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

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

Исходный код:
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

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

parentTableName
String

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

parentTableNamespace
String

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

childTableName
String

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

childTableNamespace
String

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

parentColumnNames
String[]

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

childColumnNames
String[]

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

nested
Boolean

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

Атрибуты

Комментарии

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

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