ConstraintCollection.Add メソッド (String, DataColumn , Boolean)

指定した名前、 DataColumn オブジェクトの配列、およびその列が主キーかどうかを示す値を使用して新しい UniqueConstraint を作成し、その制約をコレクションに追加します。

Overloads Public Overridable Function Add( _
   ByVal name As String, _   ByVal columns() As DataColumn, _   ByVal primaryKey As Boolean _) As Constraint
[C#]
public virtual Constraint Add(stringname,DataColumn[] columns,boolprimaryKey);
[C++]
public: virtual Constraint* Add(String* name,DataColumn* columns[],boolprimaryKey);
[JScript]
public function Add(
   name : String,columns : DataColumn[],primaryKey : Boolean) : Constraint;

パラメータ

• name
  UniqueConstraint の名前。
• columns
  制約を適用する DataColumn オブジェクトの配列。
• primaryKey
  その列が主キー列であると指定する場合は true 。それ以外の場合は false 。

戻り値

新しい UniqueConstraint 。

例外

例外の種類	条件
ArgumentException	この制約は既にこのコレクションに属しています。 または この制約は他のコレクションに属しています。
DuplicateNameException	このコレクションには指定した名前の制約が既に含まれています。比較では、大文字と小文字が区別されません。

解説

制約が正常に追加された場合は、 CollectionChanged イベントが発生します。

使用例

[Visual Basic, C#, C++] 指定した DataTable に新しい UniqueConstraint を作成するための DataColumn オブジェクトの配列を作成する例を次に示します。

 
Private Sub AddUniqueConstraint(myTable As DataTable)
    Dim myColumns(1) As DataColumn
    myColumns(0) = myTable.Columns("ID")
    myColumns(1) = myTable.Columns("Name")
    myTable.Constraints.Add("idNameConstraint", myColumns, True)
End Sub

[C#] 
private void AddUniqueConstraint(DataTable myTable){
   DataColumn[] myColumns = new DataColumn[1];
   myColumns[0] = myTable.Columns["ID"];
   myColumns[1] = myTable.Columns["Name"];
   myTable.Constraints.Add("idNameConstraint", myColumns, true);
}

[C++] 
private:
 void AddUniqueConstraint(DataTable* myTable){
    DataColumn* myColumns[] = new DataColumn*[1];
    myColumns->Item[0] = myTable->Columns->Item[S"ID"];
    myColumns->Item[1] = myTable->Columns->Item[S"Name"];
    myTable->Constraints->Add(S"idNameConstraint", myColumns, true);
 }

[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

参照

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