DataGridViewRowCollection.Add Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona uma ou mais linhas à coleção.

Sobrecargas

Nome	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 popula as células com os objetos especificados.
Add(DataGridViewRow)	Adiciona o especificado DataGridViewRow à coleção.

Add()

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 -> int

Public Overridable Function Add () As Integer

Retornos

Int32

O índice da nova linha.

Exceções

InvalidOperationException

O controle associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas linhas sejam adicionadas:

• Selecionando todas as células no controle.

• Desmarcando a seleção.

- ou -

Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A DataSource propriedade do DataGridView não nullé .

- ou -

Não DataGridView tem colunas.

- ou -

Essa operação adicionaria uma linha congelada após linhas descongeladas.

ArgumentException

A linha retornada pela RowTemplate propriedade tem mais células do que colunas no controle.

Comentários

A Add() sobrecarga adiciona linhas que se baseiam no RowTemplate .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 As práticas recomendadas para dimensionar o 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 dimensionar o controle DataGridView dos Windows Forms

Add(Int32)

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 -> 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 associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas linhas sejam adicionadas:

• Selecionando todas as células no controle.

• Desmarcando a seleção.

- ou -

Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A DataSource propriedade do DataGridView não nullé .

- ou -

Não DataGridView tem colunas.

- ou -

A linha retornada pela RowTemplate propriedade tem mais células do que colunas no controle.

- ou -

Essa operação adicionaria linhas congeladas após linhas descongeladas.

Comentários

O Add(Int32) método adiciona linhas compartilhadas ao DataGridViewRowCollection. As novas linhas são baseadas no RowTemplate .DataGridView Verifique se a linha especificada na RowTemplate propriedade pode ser compartilhada para melhor escalabilidade. Para obter mais informações, consulte As práticas recomendadas para dimensionar o 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

Add(Object[])

Origem:

DataGridViewRowCollection.cs

Adiciona uma nova linha à coleção e popula 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 preenchem as células do novo DataGridViewRow.

Retornos

Int32

O índice da nova linha.

Exceções

ArgumentNullException

values é null.

InvalidOperationException

O controle associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas linhas sejam adicionadas:

• Selecionando todas as células no controle.

• Desmarcando a seleção.

- ou -

Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A propriedade VirtualMode do DataGridView é definida como true.

- ou -

A DataSource propriedade do DataGridView não nullé .

- ou -

Não DataGridView tem colunas.

- ou -

A linha retornada pela RowTemplate propriedade tem mais células do que colunas no controle.

- ou -

Essa operação adicionaria uma linha congelada após linhas descongeladas.

Comentários

O Add(Object[]) método adiciona uma linha não compartilhada ao DataGridViewRowCollection. Para obter mais informações, consulte As práticas recomendadas para dimensionar o 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

Add(DataGridViewRow)

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 -> 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 associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas linhas sejam adicionadas:

• Selecionando todas as células no controle.

• Desmarcando a seleção.

- ou -

Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- 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 -

Essa operação adicionaria uma linha congelada após linhas descongeladas.

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 As práticas recomendadas para dimensionar o 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 dimensionar o controle DataGridView dos Windows Forms