DataRowCollection.Add メソッド (DataRow)

指定した DataRow を DataRowCollection オブジェクトに追加します。

Overloads Public Sub Add( _
   ByVal row As DataRow _)
[C#]
public void Add(DataRowrow);
[C++]
public: void Add(DataRow* row);
[JScript]
public function Add(
   row : DataRow);

パラメータ

• row
  追加する DataRow 。

戻り値

新しい DataRow 。

例外

例外の種類	条件
ArgumentNullException	行が null です。
ArgumentException	この行は他のテーブルに属しているか、既にこのテーブルに属しています。
ConstraintException	この行を追加すると、制約が無効になります。
NoNullAllowedException	この行を追加すると、 AllowDBNull が false である DataColumn に null を格納することになります。

解説

新しい DataRow を作成するには、 DataTable クラスの NewRow メソッドを使用する必要があります。 NewRow メソッドを使用すると、親 DataTable のスキーマを使用して、新しい DataRow オブジェクトが返されます。 DataRow オブジェクトを作成し、このオブジェクトの各列の値を設定した後、 Add メソッドを使用して、このオブジェクトをコレクションに追加します。

ユーザーの操作によって RowChanging イベントで例外が生成された場合は、例外を生成します。例外が発生した場合、その行はテーブルに追加されません。

使用例

[Visual Basic, C#, C++] Add メソッドを使用して、新しい DataRow を DataRowCollection オブジェクトに追加する例を次に示します。

 
Private Sub AddDataRow(ByVal myTable As DataTable)
    Dim rc As DataRowCollection
    Dim newRow As DataRow
    rc = myTable.Rows
    newRow = myTable.NewRow()
    ' Assuming the table has two columns, set their values.
    newRow(0) = "hello"
    newRow(1) = "world"
    rc.Add(newRow)
 End Sub

[C#] 
private void AddDataRow(DataTable myTable){
    DataRowCollection rc;
    DataRow newRow;
    rc = myTable.Rows;
    newRow = myTable.NewRow();
    // Assuming the table has two columns, set their values.
    newRow[0] = "hello";
    newRow[1] = "world";
    rc.Add(newRow);
 }

[C++] 
private:
void AddDataRow(DataTable* myTable){
    DataRowCollection* rc;
    DataRow* newRow;
    rc = myTable->Rows;
    newRow = myTable->NewRow();
    // Assuming the table has two columns, set their values.
    newRow->Item[0] = S"hello";
    newRow->Item[1] = S"world";
    rc->Add(newRow);
 }

[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

参照

DataRowCollection クラス | DataRowCollection メンバ | System.Data 名前空間 | DataRowCollection.Add オーバーロードの一覧 | Clear | DataTable | DataRow | NewRow | Remove