DataRowCollection.Add メソッド

定義

DataRowDataRowCollection に追加します。Adds a DataRow to the DataRowCollection.

オーバーロード

Add(DataRow)

指定した DataRowDataRowCollection オブジェクトに追加します。Adds the specified DataRow to the DataRowCollection object.

Add(Object[])

指定した値を使用して行を作成し、この行を DataRowCollection に追加します。Creates a row using specified values and adds it to the DataRowCollection.

Add(DataRow)

指定した DataRowDataRowCollection オブジェクトに追加します。Adds the specified DataRow to the DataRowCollection object.

public:
 void Add(System::Data::DataRow ^ row);
public void Add (System.Data.DataRow row);
member this.Add : System.Data.DataRow -> unit
Public Sub Add (row As DataRow)

パラメーター

row
DataRow

追加する DataRowThe DataRow to add.

例外

行が null です。The row is null.

この行は他のテーブルに属しているか、既にこのテーブルに属しています。The row either belongs to another table or already belongs to this table.

この行を追加すると、制約が無効になります。The addition invalidates a constraint.

この行を追加すると、DataColumn が false である AllowDBNull に null を格納することになります。The addition tries to put a null in a DataColumn where AllowDBNull is false.

次の例では、メソッドを使用して Add 、オブジェクトに新しいを追加し DataRow DataRowCollection ます。The following example uses the Add method to add a new DataRow to a DataRowCollection object.

private void ShowRows(DataTable table)
{
    // Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count);
    // Print the value of columns 1 in each row
    foreach(DataRow row in table.Rows)
    {
        Console.WriteLine(row[1]);
    }
}

private void AddRow(DataTable table)
{
    DataRowCollection rowCollection = table.Rows;
    // Instantiate a new row using the NewRow method.

    DataRow newRow = table.NewRow();
    // Insert code to fill the row with values.

    // Add the row to the DataRowCollection.
    table.Rows.Add(newRow);
}
Private Sub ShowRows(Byval table As DataTable)
    ' Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count)

    Dim row  As DataRow
    ' Print the value of columns 1 in each row
    For Each row In table.Rows
        Console.WriteLine(row(1))
    Next
End Sub
 
Private Sub AddRow(ByVal table As DataTable)
    ' Instantiate a new row using the NewRow method.
    Dim newRow As DataRow = table.NewRow()
    ' Insert code to fill the row with values.

    ' Add the row to the DataRowCollection.
    table.Rows.Add(newRow)
End Sub

注釈

新しいを作成するには、 DataRow クラスのメソッドを使用する必要があり NewRow DataTable ます。To create a new DataRow, you must use the NewRow method of the DataTable class. メソッドを使用すると NewRowDataRow 親のスキーマを使用して新しいオブジェクトが返され DataTable ます。When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. オブジェクトを作成 DataRow し、各列の値を設定したら、メソッドを使用してオブジェクトを Add コレクションに追加します。After you create the DataRow object and set the values for each of its columns, use the Add method to add the object to the collection.

は、ユーザーがイベントで例外を生成した場合に、例外を生成し RowChanging ます。Generates an exception if the user generates an exception in the RowChanging event. 例外が発生した場合、行はテーブルに追加されません。If an exception occurs, the row is not added to the table.

こちらもご覧ください

適用対象

Add(Object[])

指定した値を使用して行を作成し、この行を DataRowCollection に追加します。Creates a row using specified values and adds it to the DataRowCollection.

public:
 System::Data::DataRow ^ Add(... cli::array <System::Object ^> ^ values);
public:
 virtual System::Data::DataRow ^ Add(cli::array <System::Object ^> ^ values);
public System.Data.DataRow Add (params object?[] values);
public System.Data.DataRow Add (params object[] values);
public virtual System.Data.DataRow Add (object[] values);
member this.Add : obj[] -> System.Data.DataRow
abstract member Add : obj[] -> System.Data.DataRow
override this.Add : obj[] -> System.Data.DataRow
Public Function Add (ParamArray values As Object()) As DataRow
Public Overridable Function Add (values As Object()) As DataRow

パラメーター

values
Object[]

新しい行の作成に使用する値の配列。The array of values that are used to create the new row.

戻り値

DataRow

[なし] :None.

例外

配列がテーブルの列数より大きいです。The array is larger than the number of columns in the table.

値が各列の型と一致していません。A value does not match its respective column type.

この行を追加すると、制約が無効になります。Adding the row invalidates a constraint.

AllowDBNull が false である列に null を格納しようとしました。Trying to put a null in a column where AllowDBNull is false.

次の例では、メソッドを使用し Add て、新しいオブジェクトを作成し、に追加し DataRow DataRowCollection ます。The following example uses the Add method to create and add a new DataRow object to a DataRowCollection.

private void AddRow(DataTable table)
{
    // Create an array with three elements.
    object[] rowVals = new object[3];
    DataRowCollection rowCollection = table.Rows;
    rowVals[0] = "hello";
    rowVals[1] = "world";
    rowVals[2] = "two";

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

    ' Add and return the new row.
    Dim row As DataRow = rowCollection.Add(rowVals) 
End Sub

注釈

オブジェクトの DataColumnAutoIncrement True に設定されている場合は、その列の既定値を取得するために null を渡す必要があります。If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

例外は、イベントまたはイベントの実行中に例外を生成した場合にも発生する可能性があり ColumnChanging RowChanging ます。Exceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. 例外が発生した場合、行はテーブルに追加されません。If an exception occurs, the row is not added to the table.

こちらもご覧ください

適用対象