DataGridViewRowCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Aggiunge una o più righe all'insieme.

Overload

Nome	Descrizione
Add()	Aggiunge una nuova riga all'insieme.
Add(Int32)	Aggiunge il numero specificato di nuove righe all'insieme.
Add(Object[])	Aggiunge una nuova riga all'insieme e popola le celle con gli oggetti specificati.
Add(DataGridViewRow)	Aggiunge l'oggetto specificato DataGridViewRow all'insieme.

Add()

Origine:

DataGridViewRowCollection.cs

Aggiunge una nuova riga all'insieme.

public:
 virtual int Add();

public virtual int Add();

abstract member Add : unit -> int
override this.Add : unit -> int

Public Overridable Function Add () As Integer

Restituisce

Int32

Indice della nuova riga.

Eccezioni

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di nuove righe:

• Selezione di tutte le celle nel controllo .

• Cancellazione della selezione.

oppure

Questo metodo viene chiamato da un gestore per uno degli eventi seguenti DataGridView :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

oppure

La DataSource proprietà di DataGridView non nullè .

oppure

Non DataGridView dispone di colonne.

oppure

Questa operazione aggiunge una riga bloccata dopo le righe non bloccate.

ArgumentException

La riga restituita dalla RowTemplate proprietà contiene più celle di quelle presenti nel controllo .

Commenti

L'overload Add() aggiunge righe basate sull'oggetto RowTemplate dell'oggetto DataGridView. La nuova riga viene condivisa, se possibile. Assicurarsi che la riga specificata nella RowTemplate proprietà possa essere condivisa per una migliore scalabilità. Per altre informazioni, vedere Procedure consigliate per il ridimensionamento del controllo DataGridView di Windows Form.

Le righe nel controllo non vengono ordinate automaticamente quando vengono aggiunte nuove righe. Per ordinare nuove righe nella posizione corretta, chiamare il DataGridView.Sort metodo in un DataGridView.RowsAdded gestore eventi. È anche possibile chiamare il DataGridView.Sort metodo in un CellValueChanged gestore eventi per ordinare le righe quando l'utente modifica una cella.

Vedi anche

• DataGridView
• DataGridViewRow
• Procedure consigliate per il ridimensionamento del controllo DataGridView di Windows Form

Add(Int32)

Origine:

DataGridViewRowCollection.cs

Aggiunge il numero specificato di nuove righe all'insieme.

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

Parametri

count

Int32

Numero di righe da aggiungere all'oggetto DataGridViewRowCollection.

Restituisce

Int32

Indice dell'ultima riga aggiunta.

Eccezioni

ArgumentOutOfRangeException

count è minore di 1.

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di nuove righe:

• Selezione di tutte le celle nel controllo .

• Cancellazione della selezione.

oppure

Questo metodo viene chiamato da un gestore per uno degli eventi seguenti DataGridView :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

oppure

La DataSource proprietà di DataGridView non nullè .

oppure

Non DataGridView dispone di colonne.

oppure

La riga restituita dalla RowTemplate proprietà contiene più celle di quelle presenti nel controllo .

oppure

Questa operazione aggiungerà righe bloccate dopo le righe non bloccate.

Commenti

Il Add(Int32) metodo aggiunge righe condivise all'oggetto DataGridViewRowCollection. Le nuove righe sono basate su RowTemplate di DataGridView. Assicurarsi che la riga specificata nella RowTemplate proprietà possa essere condivisa per una migliore scalabilità. Per altre informazioni, vedere Procedure consigliate per il ridimensionamento del controllo DataGridView di Windows Form.

Le righe nel controllo non vengono ordinate automaticamente quando vengono aggiunte nuove righe. Per ordinare nuove righe nella posizione corretta, chiamare il DataGridView.Sort metodo in un DataGridView.RowsAdded gestore eventi. È anche possibile chiamare il DataGridView.Sort metodo in un CellValueChanged gestore eventi per ordinare le righe quando l'utente modifica una cella.

Vedi anche

• DataGridView
• DataGridViewRow

Add(Object[])

Origine:

DataGridViewRowCollection.cs

Aggiunge una nuova riga all'insieme e popola le celle con gli oggetti specificati.

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

Parametri

values

Object[]

Numero variabile di oggetti che popolano le celle del nuovo DataGridViewRowoggetto .

Restituisce

Int32

Indice della nuova riga.

Eccezioni

ArgumentNullException

values è null.

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di nuove righe:

• Selezione di tutte le celle nel controllo .

• Cancellazione della selezione.

oppure

Questo metodo viene chiamato da un gestore per uno degli eventi seguenti DataGridView :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

oppure

La proprietà VirtualMode del DataGridView è impostata su true.

oppure

La DataSource proprietà di DataGridView non nullè .

oppure

Non DataGridView dispone di colonne.

oppure

La riga restituita dalla RowTemplate proprietà contiene più celle di quelle presenti nel controllo .

oppure

Questa operazione aggiunge una riga bloccata dopo le righe non bloccate.

Commenti

Il Add(Object[]) metodo aggiunge una riga non condivisa all'oggetto DataGridViewRowCollection. Per altre informazioni, vedere Procedure consigliate per il ridimensionamento del controllo DataGridView di Windows Form.

Le righe nel controllo non vengono ordinate automaticamente quando vengono aggiunte nuove righe. Per ordinare nuove righe nella posizione corretta, chiamare il DataGridView.Sort metodo in un DataGridView.RowsAdded gestore eventi. È anche possibile chiamare il DataGridView.Sort metodo in un CellValueChanged gestore eventi per ordinare le righe quando l'utente modifica una cella.

Vedi anche

• DataGridView
• DataGridViewRow

Add(DataGridViewRow)

Origine:

DataGridViewRowCollection.cs

Aggiunge l'oggetto specificato DataGridViewRow all'insieme.

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

Parametri

dataGridViewRow

DataGridViewRow

Oggetto DataGridViewRow da aggiungere all'oggetto DataGridViewRowCollection.

Restituisce

Int32

Indice del nuovo DataGridViewRowoggetto .

Eccezioni

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di nuove righe:

• Selezione di tutte le celle nel controllo .

• Cancellazione della selezione.

oppure

Questo metodo viene chiamato da un gestore per uno degli eventi seguenti DataGridView :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

oppure

La DataSource proprietà di DataGridView non nullè .

oppure

Non DataGridView dispone di colonne.

oppure

La DataGridView proprietà di dataGridViewRow non nullè .

oppure

dataGridViewRow ha un Selected valore della proprietà pari a true.

oppure

Questa operazione aggiunge una riga bloccata dopo le righe non bloccate.

ArgumentNullException

dataGridViewRow è null.

ArgumentException

dataGridViewRow contiene più celle di quelle presenti nel controllo .

Commenti

Il Add(DataGridViewRow) metodo aggiunge una riga condivisa all'oggetto DataGridViewRowCollection, se possibile. In caso contrario, la nuova riga non è condivisa. Per altre informazioni, vedere Procedure consigliate per il ridimensionamento del controllo DataGridView di Windows Form.

Le righe nel controllo non vengono ordinate automaticamente quando vengono aggiunte nuove righe. Per ordinare nuove righe nella posizione corretta, chiamare il DataGridView.Sort metodo in un DataGridView.RowsAdded gestore eventi. È anche possibile chiamare il DataGridView.Sort metodo in un CellValueChanged gestore eventi per ordinare le righe quando l'utente modifica una cella.

Vedi anche

• DataGridView
• DataGridViewRow
• DataGridViewColumn
• CellTemplate
• Procedure consigliate per il ridimensionamento del controllo DataGridView di Windows Form