Partilhar via

DataGridViewRowCollection.Add Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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 -> int
Public Overridable Function Add () As Integer

Retornos

Int32

O índice da nova linha.

Exceções

InvalidOperationException

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.

ArgumentException

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

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 -> int
Public Overridable Function Add (count As Integer) As Integer

Parâmetros

count
Int32

O número de linhas a serem adicionadas ao DataGridViewRowCollection.

Retornos

Int32

O índice da última linha que foi adicionada.

Exceções

ArgumentOutOfRangeException

count é menor que 1.

InvalidOperationException

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[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer

Parâmetros

values
Object[]

Um número variável de objetos que preenche as células da nova DataGridViewRow.

Retornos

Int32

O índice da nova linha.

Exceções

ArgumentNullException

values é null.

InvalidOperationException

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 -> int
Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

Parâmetros

dataGridViewRow
DataGridViewRow

O DataGridViewRow para adicionar ao DataGridViewRowCollection.

Retornos

Int32

O índice do novo DataGridViewRow.

Exceções

InvalidOperationException

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.

ArgumentNullException

dataGridViewRow é null.

ArgumentException

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

Aplica-se a