DataGridViewRowCollection.AddCopy(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 uma nova linha com base na linha no índice especificado.
public:
virtual int AddCopy(int indexSource);public virtual int AddCopy(int indexSource);abstract member AddCopy : int -> int
override this.AddCopy : int -> intPublic Overridable Function AddCopy (indexSource As Integer) As IntegerParâmetros
- indexSource
- Int32
O índice da linha sobre a qual basear a nova linha.
Devoluções
O índice da nova linha.
Exceções
indexSource é menor que zero ou maior ou igual ao número de linhas na coleção.
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 da nova linha tem os mesmos valores que a InheritedStyle da linha posicionada em indexSource. O AddCopy método adiciona uma linha partilhada ao DataGridViewRowCollection, se possível. Caso contrário, a nova linha não é partilhada. 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.