DataGridViewRowCollection.Insert 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 ou mais linhas na coleção.
Sobrecargas
| Insert(Int32, DataGridViewRow) |
Insere o DataGridViewRow especificado na coleção. |
| Insert(Int32, Int32) |
Insere o número de linhas especificado na coleção no local indicado. |
| Insert(Int32, Object[]) |
Insere uma linha na coleção na posição especificada e preenche as células com os objetos indicados. |
Insert(Int32, DataGridViewRow)
Insere o DataGridViewRow especificado na coleção.
public:
virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unitPublic Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)Parâmetros
- rowIndex
- Int32
A posição na qual inserir a linha.
- dataGridViewRow
- DataGridViewRow
O DataGridViewRow a ser inserido no DataGridViewRowCollection.
Exceções
rowIndex é menor que zero ou maior que o número de linhas na coleção.
dataGridViewRow é null.
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 -
A propriedade DataSource do DataGridView não é null.
- ou -
rowIndex é igual ao número de linhas na coleção e a propriedade AllowUserToAddRows do DataGridView é definida como true.
- ou -
O DataGridView não tem colunas.
- ou -
A propriedade DataGridView de dataGridViewRow não é null.
- ou -
dataGridViewRow tem um valor da propriedade Selected de 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.
dataGridViewRow tem mais células do que colunas no controle.
Comentários
O Insert(Int32, DataGridViewRow) 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.
Confira também
Aplica-se a
Insert(Int32, Int32)
Insere o número de linhas especificado na coleção no local indicado.
public:
virtual void Insert(int rowIndex, int count);public virtual void Insert (int rowIndex, int count);abstract member Insert : int * int -> unit
override this.Insert : int * int -> unitPublic Overridable Sub Insert (rowIndex As Integer, count As Integer)Parâmetros
- rowIndex
- Int32
A posição na qual inserir as linhas.
- count
- Int32
O número de linhas a serem inseridas no DataGridViewRowCollection.
Exceções
rowIndex é menor que zero ou maior que o número de linhas na coleção.
- ou -
count é menor que 1.
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 -
A propriedade DataSource do DataGridView não é null.
- ou -
O DataGridView não tem colunas.
- ou -
rowIndex é igual ao número de linhas na coleção e a propriedade AllowUserToAddRows do DataGridView é definida como true.
- ou -
A linha retornada pela propriedade RowTemplate tem mais células do que colunas no controle.
- 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
O Insert(Int32, Int32) método adiciona linhas baseadas no RowTemplate do DataGridView. A nova linha é compartilhada, se possível. Verifique se a linha especificada na RowTemplate propriedade pode ser compartilhada para melhor escalabilidade. 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.
Confira também
Aplica-se a
Insert(Int32, Object[])
Insere uma linha na coleção na posição especificada e preenche as células com os objetos indicados.
public:
virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);public virtual void Insert (int rowIndex, params object[] values);abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unitPublic Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())Parâmetros
- rowIndex
- Int32
A posição na qual inserir a linha.
- values
- Object[]
Um número variável de objetos que populam as células da nova linha.
Exceções
rowIndex é menor que zero ou maior que o número de linhas na coleção.
values é null.
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 -
A propriedade VirtualMode do DataGridView é definida como true.
- ou -
A propriedade DataSource do DataGridView não é null.
- ou -
O DataGridView não tem colunas.
- ou -
rowIndex é igual ao número de linhas na coleção e a propriedade AllowUserToAddRows do DataGridView é definida como true.
- ou -
A propriedade DataGridView da linha retornada pela propriedade RowTemplate do controle não é null.
- 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.
A linha retornada pela propriedade RowTemplate do controle tem mais células do que colunas no controle.
Comentários
O Insert(Int32, Object[]) método adiciona uma linha não compartilhada ao DataGridViewRowCollection.
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.
