DataGridViewRowCollection.InsertCopies(Int32, 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 linhas na coleção na posição especificada.
public:
virtual void InsertCopies(int indexSource, int indexDestination, int count);public virtual void InsertCopies(int indexSource, int indexDestination, int count);abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unitPublic Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)Parâmetros
- indexSource
- Int32
O índice no DataGridViewRow qual basear as novas linhas.
- indexDestination
- Int32
A posição na qual inserir as linhas.
- count
- Int32
O número de DataGridViewRow objetos a serem adicionados ao DataGridViewRowCollection.
Exceções
indexSource é menor que zero ou maior que o número de linhas na coleção menos uma.
- ou -
indexDestination é menor que zero ou maior que o número de linhas na coleção.
- ou -
count é menor que 1.
O controle associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas linhas sejam adicionadas:
Selecionando todas as células no controle.
Desmarcando a seleção.
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:
- ou -
indexDestination é igual ao número de linhas na coleção e AllowUserToAddRows é true.
- ou -
Essa operação inseriria linhas congeladas após linhas descongeladas ou linhas descongeladas antes de linhas congeladas.
Comentários
A InheritedStyle propriedade dos novos DataGridViewRow objetos tem os mesmos valores que o InheritedStyleDataGridViewRow do posicionado em indexSource. O InsertCopies 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 As práticas recomendadas para dimensionar o 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.
