指定した名前および親列と子列の配列を使用して 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 オーバーロードの一覧