DataGridViewRowCollection.InsertCopy(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.
Insere uma linha na coleção na posição especificada, com base na linha na posição indicada.
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 na qual basear a nova linha.
- indexDestination
- Int32
A posição na qual inserir a linha.
Exceções
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.
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 -
indexDestination é igual ao número de linhas na coleção e AllowUserToAddRows é true.
- ou -
Essa operação poderia inserir uma linha congelada após as linhas não congeladas ou uma linha não congelada antes de linhas congeladas.
Comentários
Esse método atribui a 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 compartilhada ao DataGridViewRowCollection, se possível. Caso contrário, a nova linha não será compartilhada. 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.
