DataGridViewRowCollection.AddCopies(Int32, Int32) Método

Definição

Adiciona o número especificado de linhas à coleção com base na linha no índice especificado.

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

Parâmetros

indexSource
Int32

O índice da linha sobre a qual basear as novas linhas.

count
Int32

O número de linhas a adicionar ao DataGridViewRowCollection.

Devoluções

O índice da última linha que foi adicionada.

Exceções

indexSource é inferior a zero ou maior ou igual ao número de linhas no controlo.

-ou-

count é inferior a zero.

O controlo associado DataGridView está a executar uma das seguintes ações que impede temporariamente a adição de novas linhas:

  • Selecionar todas as células no controlo.

  • A limpar a seleção.

-ou-

Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:

-ou-

A DataSource propriedade do DataGridView não nullé .

-ou-

Esta operação adicionaria uma fila congelada após as filas descongeladas.

Observações

A InheritedStyle propriedade do novo DataGridViewRow tem os mesmos valores que o InheritedStyleDataGridViewRow do posicionado em indexSource. O AddCopies método adiciona linhas partilhadas ao DataGridViewRowCollection, se possível. Caso contrário, as novas linhas não são partilhadas. Para mais informações, consulte Boas Práticas para Escalar o Controlo Windows Forms DataGridView.

As linhas no controlo não são automaticamente ordenadas quando novas linhas são adicionadas. Para ordenar as novas linhas na sua posição correta, chame o DataGridView.Sort método num DataGridView.RowsAdded gestor de eventos. Também podes querer chamar o DataGridView.Sort método num CellValueChanged gestor de eventos para ordenar as linhas quando o utilizador modifica uma célula.

Aplica-se a

Ver também