DataGridViewRowCollection.Add 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 ou mais linhas à coleção.
Sobrecargas
| 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 DataGridViewRow especificado à coleção. |
Add()
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 IntegerRetornos
O índice da nova linha.
Exceções
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 -
Essa operação adicionaria uma linha congelada após as linhas não congeladas.
A linha retornada pela propriedade RowTemplate tem mais células do que colunas no controle.
Comentários
A Add() sobrecarga 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
- DataGridView
- DataGridViewRow
- Práticas recomendadas para dimensionamento do controle DataGridView dos Windows Forms
Aplica-se a
Add(Int32)
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 serem adicionadas ao DataGridViewRowCollection.
Retornos
O índice da última linha que foi adicionada.
Exceções
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 -
A linha retornada pela propriedade RowTemplate tem mais células do que colunas no controle.
- ou -
Essa operação adicionará as linhas congeladas após as linhas não congeladas.
Comentários
O Add(Int32) método adiciona linhas compartilhadas ao DataGridViewRowCollection. As novas linhas são baseadas no RowTemplate do DataGridView. 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
Add(Object[])
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 preenche as células da nova DataGridViewRow.
Retornos
O índice da nova linha.
Exceções
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 -
A linha retornada pela propriedade RowTemplate tem mais células do que colunas no controle.
- ou -
Essa operação adicionaria uma linha congelada após as linhas não congeladas.
Comentários
O Add(Object[]) método adiciona uma linha nãohared ao DataGridViewRowCollection. 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
Add(DataGridViewRow)
Adiciona o DataGridViewRow especificado à 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.
Retornos
O índice do novo DataGridViewRow.
Exceções
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 -
A propriedade DataGridView do dataGridViewRow não é null.
- ou -
dataGridViewRow tem um valor da propriedade Selected de true.
- ou -
Essa operação adicionaria uma linha congelada após as linhas não congeladas.
dataGridViewRow é null.
dataGridViewRow tem mais células do que colunas no controle.
Comentários
O Add(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
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Práticas recomendadas para dimensionamento do controle DataGridView dos Windows Forms
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de