DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insere linhas na coleção na posição especificada.

public:
 virtual void InsertCopies(int indexSource, int indexDestination, int count);

public virtual void InsertCopies (int indexSource, int indexDestination, int count);

abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit

Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)

Parâmetros

indexSource

Int32

O índice da DataGridViewRow na qual as novas linhas serão baseadas.

indexDestination

Int32

A posição na qual inserir as linhas.

count

Int32

O número de objetos DataGridViewRow a serem adicionados ao DataGridViewRowCollection.

Exceções

ArgumentOutOfRangeException

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

- ou -

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

- ou -

count é menor que 1.

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:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

indexDestination é igual ao número de linhas na coleção e AllowUserToAddRows é true.

- ou -

Essa operação poderia inserir linhas congeladas após as linhas não congeladas ou descongelar linhas antes de linhas congeladas.

Comentários

A InheritedStyle propriedade dos novos DataGridViewRow objetos tem os mesmos valores que o InheritedStyleDataGridViewRow do posicionado em indexSource. O InsertCopies 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 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.

Confira também

• DataGridView
• DataGridViewRow