DataRelation コンストラクタ (String, DataColumn[], DataColumn , Boolean)

名前、親と子で一致した DataColumn オブジェクトの配列、および制約を作成するかどうかを示す値を指定して、DataRelation クラスの新しいインスタンスを初期化します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)

構文

'宣言
Public Sub New ( _
    relationName As String, _
    parentColumns As DataColumn(), _
    childColumns As DataColumn(), _
    createConstraints As Boolean _
)
'使用
Dim relationName As String
Dim parentColumns As DataColumn()
Dim childColumns As DataColumn()
Dim createConstraints As Boolean

Dim instance As New DataRelation(relationName, parentColumns, childColumns, createConstraints)

public DataRelation (
    string relationName,
    DataColumn[] parentColumns,
    DataColumn[] childColumns,
    bool createConstraints
)

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

public DataRelation (
    String relationName, 
    DataColumn[] parentColumns, 
    DataColumn[] childColumns, 
    boolean createConstraints
)

public function DataRelation (
    relationName : String, 
    parentColumns : DataColumn[], 
    childColumns : DataColumn[], 
    createConstraints : boolean
)

パラメータ

• relationName
  リレーションシップの名前。null 参照 (Visual Basic では Nothing) または空の文字列 ("") の場合は、作成したオブジェクトを DataRelationCollection に追加するときに既定の名前が使用されます。

• parentColumns
  親 DataColumn オブジェクトの配列。

• childColumns
  子 DataColumn オブジェクトの配列。

• createConstraints
  制約を作成するかどうかを示す値。制約を作成する場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	DataColumn オブジェクトの一方または両方が null 参照 (Visual Basic では Nothing) です。
InvalidConstraintException	列のデータ型が異なります。 または テーブルが同じ DataSet に属していません。

使用例

新しい DataRelation を作成し、DataSet の DataRelationCollection に追加する例を次に示します。

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 DataRelation = New DataRelation( _
        "CustomersOrders", parentColumns, childColumns,  _
        bConstraints)

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0、1.1、1.0

.NET Compact Framework

サポート対象 : 2.0、1.0

参照

関連項目

DataRelation クラス
DataRelation メンバ
System.Data 名前空間
DataColumn クラス
ForeignKeyConstraint
RelationName