DataRowCollection.Add メソッド (Object )

指定した値を使用して行を作成し、この行を DataRowCollection に追加します。

Overloads Public Overridable Function Add( _
   ByVal values() As Object _) As DataRow
[C#]
public virtual DataRow Add(object[] values);
[C++]
public: virtual DataRow* Add(Object* values __gc[]);
[JScript]
public function Add(
   values : Object[]) : DataRow;

パラメータ

• values
  新しい行の作成に使用する値の配列。

戻り値

新しい DataRow 。

例外

解説

DataColumn オブジェクトの AutoIncrement が True に設定されている場合は、 System.Object.Empty を渡して、その列の既定値を取得する必要があります。

ColumnChanging イベントまたは RowChanging イベントで例外が生成された場合は、例外が発生することもあります。例外が発生した場合、その行はテーブルに追加されません。

使用例

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

 
Private Sub AddRow(ByVal myTable As DataTable)
    Dim rc As DataRowCollection
    Dim myNewRow As DataRow
    ' Create an array with three elements.
    Dim rowVals(2) As Object
    rc = myTable.Rows
    rowVals(0) = "hello"
    rowVals(1) = "world"
    rowVals(2) = "two"
    ' Add and return the new row.
    myNewRow = rc.Add(rowVals) 
 End Sub

[C#] 
private void AddRow(DataTable myTable){
    DataRowCollection rc; 
    DataRow myNewRow;
    // Create an array with three elements.
    object[] rowVals = new object[3];
    rc = myTable.Rows;
    rowVals[0] = "hello";
    rowVals[1] = "world";
    rowVals[2] = "two";
    // Add and return the new row.
    myNewRow = rc.Add(rowVals);
 }

[C++] 
private:
void AddRow(DataTable* myTable){
    DataRowCollection* rc; 
    DataRow* myNewRow;
    // Create an array with three elements.
    Object* rowVals[] = new Object*[3];
    rc = myTable->Rows;
    rowVals[0] = S"hello";
    rowVals[1] = S"world";
    rowVals[2] = S"two";
    // Add and return the new row.
    myNewRow = rc->Add(rowVals);
 }

[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