DataGridViewRowCollection.AddCopies(Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.