DataRowCollection.InsertAt(DataRow, Int32) Method

Definition

Inserts a new row into the collection at the specified location.

public:
 void InsertAt(System::Data::DataRow ^ row, int pos);
public void InsertAt (System.Data.DataRow row, int pos);
member this.InsertAt : System.Data.DataRow * int -> unit
Public Sub InsertAt (row As DataRow, pos As Integer)

Parameters

row
DataRow

The DataRow to add.

pos
Int32

The (zero-based) location in the collection where you want to add the DataRow.

Exceptions

The pos is less than 0.

Remarks

The location specified by InsertAt is reflected by the order of rows in the DataRowCollection only. If more than one row is returned in a DataRow array, the inserted row may not be returned in the location specified by InsertAt. For example, the Rows property returns the row in the specified insert position. Select and GetChildRows may not. When you write the contents of the DataRowCollection as XML, for example, WriteXml, the rows are written according to the order specified by the DataRowCollection.

If the value specified for the pos parameter is greater than the number of rows in the collection, the new row is added to the end.

Applies to