DataRowCollection.InsertAt(DataRow, Int32) Methode

Definition

Fügt eine neue Zeile an der angegebenen Position in die Auflistung ein.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)

Parameter

row
DataRow

Das hinzuzufügende DataRow.The DataRow to add.

pos
Int32

Die (nullbasierte) Position in der Auflistung, wo Sie die DataRow hinzufügen möchten.The (zero-based) location in the collection where you want to add the DataRow.

Ausnahmen

Die pos ist kleiner als 0.The pos is less than 0.

Hinweise

Der von InsertAt angegebene Speicherort wird nur durch die Reihenfolge der Zeilen DataRowCollection in der angegeben.The location specified by InsertAt is reflected by the order of rows in the DataRowCollection only. Wenn in einem DataRow -Array mehr als eine Zeile zurückgegeben wird, wird die eingefügte Zeile möglicherweise nicht an InsertAtdem durch angegebenen Speicherort zurückgegeben.If more than one row is returned in a DataRow array, the inserted row may not be returned in the location specified by InsertAt. Beispielsweise gibt die Rows -Eigenschaft die Zeile in der angegebenen Einfügeposition zurück.For example, the Rows property returns the row in the specified insert position. Selectund GetChildRows möglicherweise nicht.Select and GetChildRows may not. Wenn Sie den Inhalt DataRowCollection der als XML-Datei schreiben, WriteXmlz DataRowCollection. b., werden die Zeilen entsprechend der von angegebenen Reihenfolge geschrieben.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.

Wenn der für den pos -Parameter angegebene Wert größer als die Anzahl der Zeilen in der Auflistung ist, wird die neue Zeile am Ende hinzugefügt.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.

Gilt für: