次の方法で共有


DataRelationCollection.Add メソッド (String, DataColumn[], DataColumn )

指定した名前および親列と子列の配列を使用して DataRelation を作成し、このリレーションシップをコレクションに追加します。

Overloads Public Overridable Function Add( _
   ByVal name As String, _   ByVal parentColumns() As DataColumn, _   ByVal childColumns() As DataColumn _) As DataRelation
[C#]
public virtual DataRelation Add(stringname,DataColumn[] parentColumns,DataColumn[] childColumns);
[C++]
public: virtual DataRelation* Add(String* name,DataColumn* parentColumns[],DataColumn* childColumns[]);
[JScript]
public function Add(
   name : String,parentColumns : DataColumn[],childColumns : DataColumn[]) : DataRelation;

パラメータ

  • name
    作成する DataRelation の名前。
  • parentColumns
    DataColumn オブジェクトの配列。
  • childColumns
    DataColumn オブジェクトの配列。

戻り値

作成された DataRelation

例外

例外の種類 条件
ArgumentNullException リレーションシップ名が null 値です。
ArgumentException リレーションシップは、既にこのコレクションに属しているか、他のコレクションに属しています。
DuplicateNameException コレクションには、既に同じ名前のリレーションシップが含まれています。比較では、大文字と小文字が区別されません。
InvalidConstraintException リレーションシップの作成後に、そのリレーションシップが無効な状態になりました。

解説

リレーションシップがコレクションに正常に追加された場合は、 CollectionChanged イベントが発生します。

使用例

 
Private Sub AddRelation()
    Dim myTable As New DataTable()
    Dim myCol1 As DataColumn = myTable.Columns.Add("Column1")
    Dim myCol2 As DataColumn = myTable.Columns.Add("Column2")
    myTable.ChildRelations.Add("New Relation", myCol1, myCol2)
End Sub

[C#] 
private void AddRelation() {
   DataTable myTable = new DataTable();
   DataColumn myCol1 = myTable.Columns.Add("Column1");
   DataColumn myCol2 = myTable.Columns.Add("Column2");
   myTable.ChildRelations.Add("New Relation", myCol1, myCol2);
}

[C++] 
private:
 void AddRelation() {
    DataTable* myTable = new DataTable();
    DataColumn* myCol1 = myTable->Columns->Add(S"Column1");
    DataColumn* myCol2 = myTable->Columns->Add(S"Column2");
    myTable->ChildRelations->Add(S"New Relation", myCol1, myCol2);
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataRelationCollection クラス | DataRelationCollection メンバ | System.Data 名前空間 | DataRelationCollection.Add オーバーロードの一覧