DataGridViewRowCollection.Insert Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insere uma ou mais linhas na coleção.

Sobrecargas

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

Insert(Int32, DataGridViewRow)

Origem:

DataGridViewRowCollection.cs

Insere o especificado DataGridViewRow 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

A DataGridViewRow inserção DataGridViewRowCollectionno .

Exceções

ArgumentOutOfRangeException

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

ArgumentNullException

dataGridViewRow é null.

InvalidOperationException

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

• Selecionando todas as células no controle.

• Desmarcando a seleção.

- ou -

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A DataSource propriedade do DataGridView não nullé .

- ou -

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

- ou -

Não DataGridView tem colunas.

- ou -

A DataGridView propriedade de dataGridViewRow não nullé .

- ou -

dataGridViewRow tem um Selected valor de propriedade de true.

- ou -

Essa operação inseriria uma linha congelada após linhas descongeladas ou uma linha descongelada antes das 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 As práticas recomendadas para dimensionar o 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 especificado de linhas na coleção no local especificado.

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 associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas linhas sejam adicionadas:

• Selecionando todas as células no controle.

• Desmarcando a seleção.

- ou -

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A DataSource propriedade do DataGridView não nullé .

- ou -

Não DataGridView tem colunas.

- ou -

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

- ou -

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

- ou -

Essa operação inseriria uma linha congelada após linhas descongeladas ou uma linha descongelada antes das linhas congeladas.

Comentários

O Insert(Int32, Int32) método adiciona linhas que se baseiam no RowTemplate .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 As práticas recomendadas para dimensionar o 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 especificados.

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 preenchem 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 associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas linhas sejam adicionadas:

• Selecionando todas as células no controle.

• Desmarcando a seleção.

- ou -

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A propriedade VirtualMode do DataGridView é definida como true.

- ou -

A DataSource propriedade do DataGridView não nullé .

- ou -

Não DataGridView tem colunas.

- ou -

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

- ou -

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

- ou -

Essa operação inseriria uma linha congelada após linhas descongeladas ou uma linha descongelada antes das linhas congeladas.

ArgumentException

A linha retornada pela propriedade do RowTemplate 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