DataGridViewRowCollection.AddCopies(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.
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 na qual basear as novas linhas.
- count
- Int32
O número de linhas a serem adicionadas ao DataGridViewRowCollection.
Retornos
O índice da última linha que foi adicionada.
Exceções
indexSource é menor que zero ou maior ou igual ao número de linhas no controle.
- ou -
count é menor que zero.
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 -
A DataSource propriedade do DataGridView não nullé .
- ou -
Essa operação adicionaria uma linha congelada após linhas descongeladas.
Comentários
A InheritedStyle propriedade do novo DataGridViewRow tem os mesmos valores que o InheritedStyleDataGridViewRow do posicionado em indexSource. O AddCopies 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.