Compartilhar via


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 na qual basear as novas linhas.

count
Int32

O número de linhas a serem adicionadas ao DataGridViewRowCollection.

Retornos

O índice da última linha que foi adicionada.

Exceções

indexSource é menor que zero ou maior ou igual ao número de linhas no controle.

- ou -

count é menor que zero.

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:

- ou -

A DataSource propriedade do DataGridView não nullé .

- ou -

Essa operação adicionaria uma linha congelada após linhas descongeladas.

Comentários

A InheritedStyle propriedade do novo DataGridViewRow tem os mesmos valores que o InheritedStyleDataGridViewRow do posicionado em indexSource. O AddCopies método adiciona linhas compartilhadas ao DataGridViewRowCollection, se possível. Caso contrário, as novas linhas não serão compartilhadas. 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.

Aplica-se a

Confira também