次の方法で共有


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

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

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

構文

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

Dim instance As New DataRelation(relationName, parentColumn, childColumn)
public DataRelation (
    string relationName,
    DataColumn parentColumn,
    DataColumn childColumn
)
public:
DataRelation (
    String^ relationName, 
    DataColumn^ parentColumn, 
    DataColumn^ childColumn
)
public DataRelation (
    String relationName, 
    DataColumn parentColumn, 
    DataColumn childColumn
)
public function DataRelation (
    relationName : String, 
    parentColumn : DataColumn, 
    childColumn : DataColumn
)

パラメータ

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

例外

例外の種類 条件

ArgumentNullException

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

InvalidConstraintException

列のデータ型が異なります。

または

テーブルが同じ 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 parentCols() As DataColumn = New DataColumn() _
        {DataSet1.Tables("Customers").Columns("CustID"), _
        DataSet1.Tables("Customers").Columns("OrdID")}
    Dim childCols() As DataColumn = New DataColumn() _
        {DataSet1.Tables("Orders").Columns("CustID"), _
        DataSet1.Tables("Orders").Columns("OrdID")}

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

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub
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);
}

プラットフォーム

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 クラス
RelationName