DataGridViewRowCollection.AddCopy(Int32) Método

  • Referência

Definição

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

Adiciona uma nova linha com base na linha no índice especificado.

public:
 virtual int AddCopy(int indexSource);
public virtual int AddCopy (int indexSource);
abstract member AddCopy : int -> int
override this.AddCopy : int -> int
Public Overridable Function AddCopy (indexSource As Integer) As Integer

Parâmetros

indexSource
Int32

O índice da linha na qual basear a nova linha.

Retornos

Int32

O índice da nova linha.

Exceções

ArgumentOutOfRangeException

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

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 -

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

Comentários

A InheritedStyle propriedade da nova linha tem os mesmos valores que a InheritedStyle da linha posicionada em indexSource. O AddCopy método adiciona uma linha compartilhada ao DataGridViewRowCollection, se possível. Caso contrário, a nova linha não será exibida. 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.

Aplica-se a

Confira também