次の方法で共有


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

DataRelation 名、および親と子で一致した DataColumn オブジェクトの配列を指定して、DataRelation クラスの新しいインスタンスを初期化します。

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

構文

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

Dim instance As New DataRelation(relationName, parentColumns, childColumns)
public DataRelation (
    string relationName,
    DataColumn[] parentColumns,
    DataColumn[] childColumns
)
public:
DataRelation (
    String^ relationName, 
    array<DataColumn^>^ parentColumns, 
    array<DataColumn^>^ childColumns
)
public DataRelation (
    String relationName, 
    DataColumn[] parentColumns, 
    DataColumn[] childColumns
)
public function DataRelation (
    relationName : String, 
    parentColumns : DataColumn[], 
    childColumns : DataColumn[]
)

パラメータ

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

例外

例外の種類 条件

ArgumentNullException

DataColumn オブジェクトの一方または両方が null 参照 (Visual Basic では Nothing) を格納しています。

InvalidConstraintException

DataColumn オブジェクトのデータ型が異なります。

または

配列の一方または両方が、同じテーブルの異なる列で構成されていません。

または

テーブルが同じ DataSet に属していません。

使用例

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

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

    ' 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