DataGridViewRowCollection.Insert Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Insere uma ou mais linhas na coleção.
Sobrecargas
| Name | Description |
|---|---|
| Insert(Int32, DataGridViewRow) |
Insere o especificado DataGridViewRow na coleção. |
| Insert(Int32, Int32) |
Insere o número especificado de linhas na coleção no local especificado. |
| Insert(Int32, Object[]) |
Insere uma linha na coleção na posição especificada e preenche as células com os objetos especificados. |
Insert(Int32, DataGridViewRow)
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
Insere o especificado DataGridViewRow 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 em que inserir a linha.
- dataGridViewRow
- DataGridViewRow
O DataGridViewRow para inserir no DataGridViewRowCollection.
Exceções
rowIndex é inferior a zero ou superior ao número de linhas na coleção.
dataGridViewRow é null.
O controlo associado DataGridView está a executar uma das seguintes ações que impede temporariamente a adição de novas linhas:
Selecionar todas as células no controlo.
A limpar a seleção.
-ou-
Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:
-ou-
A DataSource propriedade do DataGridView não nullé .
-ou-
rowIndex é igual ao número de linhas na coleção e a AllowUserToAddRows propriedade de é DataGridView definida como true.
-ou-
Não DataGridView tem colunas.
-ou-
A DataGridView propriedade de dataGridViewRow não nullé .
-ou-
dataGridViewRow tem um Selected valor de propriedade de true.
-ou-
Esta operação inseriria uma fila congelada após as filas descongeladas ou uma fila descongelada antes das filas congeladas.
dataGridViewRow tem mais células do que colunas no controlo.
Observações
O Insert(Int32, DataGridViewRow) método adiciona uma linha partilhada ao DataGridViewRowCollection, se possível. Caso contrário, a nova linha não é partilhada. Para mais informações, consulte Boas Práticas para Escalar o Controlo Windows Forms DataGridView.
As linhas no controlo não são automaticamente ordenadas quando novas linhas são adicionadas. Para ordenar as novas linhas na sua posição correta, chame o DataGridView.Sort método num DataGridView.RowsAdded gestor de eventos. Também podes querer chamar o DataGridView.Sort método num CellValueChanged gestor de eventos para ordenar as linhas quando o utilizador modifica uma célula.
Ver também
Aplica-se a
Insert(Int32, Int32)
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
Insere o número especificado de linhas na coleção no local especificado.
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 em que inserir as linhas.
- count
- Int32
O número de linhas a inserir no DataGridViewRowCollection.
Exceções
rowIndex é inferior a zero ou superior ao número de linhas na coleção.
-ou-
count é inferior a 1.
O controlo associado DataGridView está a executar uma das seguintes ações que impede temporariamente a adição de novas linhas:
Selecionar todas as células no controlo.
A limpar a seleção.
-ou-
Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:
-ou-
A DataSource propriedade do DataGridView não nullé .
-ou-
Não DataGridView tem colunas.
-ou-
rowIndex é igual ao número de linhas na coleção e a AllowUserToAddRows propriedade de é DataGridView definida como true.
-ou-
A linha devolvida pela RowTemplate propriedade tem mais células do que colunas no controlo.
-ou-
Esta operação inseriria uma fila congelada após as filas descongeladas ou uma fila descongelada antes das filas congeladas.
Observações
O Insert(Int32, Int32) método adiciona linhas que se baseiam no RowTemplate .DataGridView A nova fila é partilhada, se possível. Certifique-se de que a linha especificada na RowTemplate propriedade pode ser partilhada para a melhor escalabilidade. Para mais informações, consulte Boas Práticas para Escalar o Controlo Windows Forms DataGridView.
As linhas no controlo não são automaticamente ordenadas quando novas linhas são adicionadas. Para ordenar as novas linhas na sua posição correta, chame o DataGridView.Sort método num DataGridView.RowsAdded gestor de eventos. Também podes querer chamar o DataGridView.Sort método num CellValueChanged gestor de eventos para ordenar as linhas quando o utilizador modifica uma célula.
Ver também
Aplica-se a
Insert(Int32, Object[])
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
Insere uma linha na coleção na posição especificada e preenche as células com os objetos especificados.
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 em que inserir a linha.
- values
- Object[]
Um número variável de objetos que preenchem as células da nova linha.
Exceções
rowIndex é inferior a zero ou superior ao número de linhas na coleção.
values é null.
O controlo associado DataGridView está a executar uma das seguintes ações que impede temporariamente a adição de novas linhas:
Selecionar todas as células no controlo.
A limpar a seleção.
-ou-
Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:
-ou-
A VirtualMode propriedade do DataGridView é definida como true.
-ou-
A DataSource propriedade do DataGridView não nullé .
-ou-
Não DataGridView tem colunas.
-ou-
rowIndex é igual ao número de linhas na coleção e a AllowUserToAddRows propriedade de é DataGridView definida como true.
-ou-
A DataGridView propriedade da linha devolvida pela propriedade do RowTemplate controlo não nullé .
-ou-
Esta operação inseriria uma fila congelada após as filas descongeladas ou uma fila descongelada antes das filas congeladas.
A linha devolvida pela propriedade do RowTemplate controlo tem mais células do que colunas no controlo.
Observações
O Insert(Int32, Object[]) método adiciona uma linha não partilhada ao DataGridViewRowCollection.
As linhas no controlo não são automaticamente ordenadas quando novas linhas são adicionadas. Para ordenar as novas linhas na sua posição correta, chame o DataGridView.Sort método num DataGridView.RowsAdded gestor de eventos. Também podes querer chamar o DataGridView.Sort método num CellValueChanged gestor de eventos para ordenar as linhas quando o utilizador modifica uma célula.
