DataGridViewRowCollection.Insert Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insere uma ou mais linhas na coleção.

Sobrecargas

Insert(Int32, DataGridViewRow)	Insere o DataGridViewRow especificado na coleção.
Insert(Int32, Int32)	Insere o número de linhas especificado na coleção no local indicado.
Insert(Int32, Object[])	Insere uma linha na coleção na posição especificada e preenche as células com os objetos indicados.

Insert(Int32, DataGridViewRow)

Origem:

DataGridViewRowCollection.cs

Insere o DataGridViewRow especificado na coleção.

public:
 virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);

public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);

abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unit

Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

Parâmetros

rowIndex

Int32

A posição na qual inserir a linha.

dataGridViewRow

DataGridViewRow

O DataGridViewRow a ser inserido no DataGridViewRowCollection.

Exceções

ArgumentOutOfRangeException

rowIndex é menor que zero ou maior que o número de linhas na coleção.

ArgumentNullException

dataGridViewRow é null.

InvalidOperationException

O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas linhas sejam adicionadas:

• Selecionar todas as células no controle.

• Limpar a seleção.

- ou -

Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A propriedade DataSource do DataGridView não é null.

- ou -

rowIndex é igual ao número de linhas na coleção e a propriedade AllowUserToAddRows do DataGridView é definida como true.

- ou -

O DataGridView não tem colunas.

- ou -

A propriedade DataGridView de dataGridViewRow não é null.

- ou -

dataGridViewRow tem um valor da propriedade Selected de true.

- ou -

Essa operação poderia inserir uma linha congelada após as linhas não congeladas ou uma linha não congelada antes de linhas congeladas.

ArgumentException

dataGridViewRow tem mais células do que colunas no controle.

Comentários

O Insert(Int32, DataGridViewRow) método adiciona uma linha compartilhada ao DataGridViewRowCollection, se possível. Caso contrário, a nova linha não será compartilhada. Para obter mais informações, consulte Práticas recomendadas para colocação em escala do controle DataGridView dos Windows Forms.

As linhas no controle não são classificadas automaticamente quando novas linhas são adicionadas. Para classificar novas linhas em sua posição correta, chame o DataGridView.Sort método em um DataGridView.RowsAdded manipulador de eventos. Talvez você também queira chamar o DataGridView.Sort método em um CellValueChanged manipulador de eventos para classificar as linhas quando o usuário modificar uma célula.

Confira também

• DataGridView
• DataGridViewRow

Insert(Int32, Int32)

Origem:

DataGridViewRowCollection.cs

Insere o número de linhas especificado na coleção no local indicado.

public:
 virtual void Insert(int rowIndex, int count);

public virtual void Insert (int rowIndex, int count);

abstract member Insert : int * int -> unit
override this.Insert : int * int -> unit

Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

Parâmetros

rowIndex

Int32

A posição na qual inserir as linhas.

count

Int32

O número de linhas a serem inseridas no DataGridViewRowCollection.

Exceções

ArgumentOutOfRangeException

rowIndex é menor que zero ou maior que o número de linhas na coleção.

- ou -

count é menor que 1.

InvalidOperationException

O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas linhas sejam adicionadas:

• Selecionar todas as células no controle.

• Limpar a seleção.

- ou -

Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A propriedade DataSource do DataGridView não é null.

- ou -

O DataGridView não tem colunas.

- ou -

rowIndex é igual ao número de linhas na coleção e a propriedade AllowUserToAddRows do DataGridView é definida como true.

- ou -

A linha retornada pela propriedade RowTemplate tem mais células do que colunas no controle.

- ou -

Essa operação poderia inserir uma linha congelada após as linhas não congeladas ou uma linha não congelada antes de linhas congeladas.

Comentários

O Insert(Int32, Int32) método adiciona linhas baseadas no RowTemplate do DataGridView. A nova linha é compartilhada, se possível. Verifique se a linha especificada na RowTemplate propriedade pode ser compartilhada para melhor escalabilidade. Para obter mais informações, consulte Práticas recomendadas para colocação em escala do controle DataGridView dos Windows Forms.

As linhas no controle não são classificadas automaticamente quando novas linhas são adicionadas. Para classificar novas linhas em sua posição correta, chame o DataGridView.Sort método em um DataGridView.RowsAdded manipulador de eventos. Talvez você também queira chamar o DataGridView.Sort método em um CellValueChanged manipulador de eventos para classificar as linhas quando o usuário modificar uma célula.

Confira também

• DataGridView
• DataGridViewRow

Insert(Int32, Object[])

Origem:

DataGridViewRowCollection.cs

Insere uma linha na coleção na posição especificada e preenche as células com os objetos indicados.

public:
 virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);

public virtual void Insert (int rowIndex, params object[] values);

abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unit

Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

Parâmetros

rowIndex

Int32

A posição na qual inserir a linha.

values

Object[]

Um número variável de objetos que populam as células da nova linha.

Exceções

ArgumentOutOfRangeException

rowIndex é menor que zero ou maior que o número de linhas na coleção.

ArgumentNullException

values é null.

InvalidOperationException

O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas linhas sejam adicionadas:

• Selecionar todas as células no controle.

• Limpar a seleção.

- ou -

Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A propriedade VirtualMode do DataGridView é definida como true.

- ou -

A propriedade DataSource do DataGridView não é null.

- ou -

O DataGridView não tem colunas.

- ou -

rowIndex é igual ao número de linhas na coleção e a propriedade AllowUserToAddRows do DataGridView é definida como true.

- ou -

A propriedade DataGridView da linha retornada pela propriedade RowTemplate do controle não é null.

- ou -

Essa operação poderia inserir uma linha congelada após as linhas não congeladas ou uma linha não congelada antes de linhas congeladas.

ArgumentException

A linha retornada pela propriedade RowTemplate do controle tem mais células do que colunas no controle.

Comentários

O Insert(Int32, Object[]) método adiciona uma linha não compartilhada ao DataGridViewRowCollection.

As linhas no controle não são classificadas automaticamente quando novas linhas são adicionadas. Para classificar novas linhas em sua posição correta, chame o DataGridView.Sort método em um DataGridView.RowsAdded manipulador de eventos. Talvez você também queira chamar o DataGridView.Sort método em um CellValueChanged manipulador de eventos para classificar as linhas quando o usuário modificar uma célula.

Confira também

• DataGridView
• DataGridViewRow