DataRowCollection.InsertAt(DataRow, Int32) Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataRowCollection.cs

Insere uma nova linha na coleção na localização especificada.

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)

Parâmetros

row

DataRow

O DataRow a ser adicionado.

pos

Int32

A localização (baseada em zero) na coleção à qual você deseja adicionar o DataRow.

Exceções

IndexOutOfRangeException

O pos é menor que 0.

Comentários

O local especificado por InsertAt é refletido pela ordem das linhas somente no DataRowCollection . Se mais de uma linha for retornada em uma DataRow matriz, a linha inserida poderá não ser retornada no local especificado por InsertAt. Por exemplo, a Rows propriedade retorna a linha na posição de inserção especificada. Select e GetChildRows talvez não. Quando você escreve o conteúdo do DataRowCollection como XML, por exemplo, WriteXml, as linhas são gravadas de acordo com a ordem especificada pelo DataRowCollection.

Se o valor especificado para o pos parâmetro for maior que o número de linhas na coleção, a nova linha será adicionada ao final.