DataGridViewRowCollection.AddCopies(Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> intPublic Overridable Function AddCopies (indexSource As Integer, count As Integer) As IntegerParâmetros
- indexSource
- Int32
O índice da linha na qual a nova linha deverá ser baseada.
- 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 o número de linhas no controle.
- ou -
count é menor que zero.
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 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 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.
