DataGridViewRowCollection.IList.Add(Object) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Adiciona um DataGridViewRow à coleção.

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
int IList.Add (object? value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

Parâmetros

value
Object

O Object para adicionar ao IList.

Retornos

Int32

O índice do novo DataGridViewRow.

Implementações

Add(Object)

Exceções

InvalidCastException

value não é um DataGridViewRow.

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:

- ou -

A propriedade DataSource do DataGridView não é null.

- ou -

O DataGridView não tem colunas.

- ou -

A propriedade DataGridView do value não é null.

- ou -

value tem um valor da propriedade Selected de true.

- ou -

Essa operação adicionaria uma linha congelada após as linhas não congeladas.

ArgumentNullException

value é null.

ArgumentException

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

Comentários

Esse método é uma implementação explícita de membro de interface. Ele só pode ser usado quando a instância de DataGridViewRowCollection é convertida em uma interface de IList.

Esse método chama a Add(DataGridViewRow) sobrecarga, passando value após a conversão para um DataGridViewRow.

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.

Aplica-se a

Confira também