DataGridViewRowCollection.Add 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.
Adiciona uma ou mais linhas à coleção.
Sobrecargas
| Name | Description |
|---|---|
| Add() |
Adiciona uma nova linha à coleção. |
| Add(Int32) |
Adiciona o número especificado de novas linhas à coleção. |
| Add(Object[]) |
Adiciona uma nova linha à coleção e preenche as células com os objetos especificados. |
| Add(DataGridViewRow) |
Adiciona o especificado DataGridViewRow à coleção. |
Add()
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
Adiciona uma nova linha à coleção.
public:
virtual int Add();public virtual int Add();abstract member Add : unit -> int
override this.Add : unit -> intPublic Overridable Function Add () As IntegerDevoluções
O índice da nova linha.
Exceções
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-
Esta operação adicionaria uma fila congelada após as filas descongeladas.
A linha devolvida pela RowTemplate propriedade tem mais células do que colunas no controlo.
Observações
A Add() sobrecarga adiciona linhas baseadas no RowTemplateDataGridView. 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
- DataGridView
- DataGridViewRow
- Práticas recomendadas para escalonar o controlo DataGridView do Windows Forms
Aplica-se a
Add(Int32)
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
Adiciona o número especificado de novas linhas à coleção.
public:
virtual int Add(int count);public virtual int Add(int count);abstract member Add : int -> int
override this.Add : int -> intPublic Overridable Function Add (count As Integer) As IntegerParâmetros
- count
- Int32
O número de linhas a adicionar ao DataGridViewRowCollection.
Devoluções
O índice da última linha que foi adicionada.
Exceções
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-
A linha devolvida pela RowTemplate propriedade tem mais células do que colunas no controlo.
-ou-
Esta operação adicionaria filas congeladas após filas descongeladas.
Observações
O Add(Int32) método adiciona linhas partilhadas ao DataGridViewRowCollection. As novas linhas baseiam-se no RowTemplate .DataGridView 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
Add(Object[])
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
Adiciona uma nova linha à coleção e preenche as células com os objetos especificados.
public:
virtual int Add(... cli::array <System::Object ^> ^ values);public virtual int Add(params object[] values);abstract member Add : obj[] -> int
override this.Add : obj[] -> intPublic Overridable Function Add (ParamArray values As Object()) As IntegerParâmetros
- values
- Object[]
Um número variável de objetos que povoam as células do novo DataGridViewRow.
Devoluções
O índice da nova linha.
Exceções
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-
A linha devolvida pela RowTemplate propriedade tem mais células do que colunas no controlo.
-ou-
Esta operação adicionaria uma fila congelada após as filas descongeladas.
Observações
O Add(Object[]) método adiciona uma linha não partilhada ao DataGridViewRowCollection. 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
Add(DataGridViewRow)
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
- Origem:
- DataGridViewRowCollection.cs
Adiciona o especificado DataGridViewRow à coleção.
public:
virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual int Add(System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> intPublic Overridable Function Add (dataGridViewRow As DataGridViewRow) As IntegerParâmetros
- dataGridViewRow
- DataGridViewRow
O DataGridViewRow para adicionar ao DataGridViewRowCollection.
Devoluções
O índice do novo DataGridViewRow.
Exceções
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-
A DataGridView propriedade do dataGridViewRow não nullé .
-ou-
dataGridViewRow tem um Selected valor de propriedade de true.
-ou-
Esta operação adicionaria uma fila congelada após as filas descongeladas.
dataGridViewRow é null.
dataGridViewRow tem mais células do que colunas no controlo.
Observações
O Add(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
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Práticas recomendadas para escalonar o controlo DataGridView do Windows Forms
