DataGridViewRowCollection.InsertCopy(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.
Insere uma linha na coleção na posição especificada, com base na linha na posição especificada.
public:
virtual void InsertCopy(int indexSource, int indexDestination);public virtual void InsertCopy(int indexSource, int indexDestination);abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unitPublic Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)Parâmetros
- indexSource
- Int32
O índice da linha sobre a qual basear a nova linha.
- indexDestination
- Int32
A posição em que inserir a linha.
Exceções
indexSource é inferior a zero ou superior ao número de linhas na coleção menos um.
-ou-
indexDestination é inferior a zero ou superior 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-
indexDestination é igual ao número de linhas na coleção e AllowUserToAddRows é true.
-ou-
Esta operação inseriria uma fila congelada após as filas descongeladas ou uma fila descongelada antes das filas congeladas.
Observações
Este método atribui à nova linha o índice especificado no indexDestination parâmetro e incrementa os índices para todas as linhas subsequentes. A InheritedStyle propriedade do novo DataGridViewRow tem os mesmos valores que o InheritedStyleDataGridViewRow do posicionado em indexSource. O InsertCopy 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.