DataGridViewRowCollection.AddCopy(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 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 na qual basear a nova linha.
Retornos
O índice da nova linha.
Exceções
indexSource é menor que zero ou maior ou igual ao número de linhas na coleção.
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 da nova linha tem os mesmos valores InheritedStyle da linha posicionada em indexSource. O AddCopy 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 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.
