DataRowCollection.InsertAt(DataRow, Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
- 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.