Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo DataGridViewRowCollection.Add (Object[])

 

Data di pubblicazione: ottobre 2016

Aggiunge una nuova riga alla raccolta e popola le celle con gli oggetti specificati.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public virtual int Add(
	params object[] values
)

Parametri

values
Type: System.Object[]

Numero variabile di oggetti che popolano le celle del nuovo oggetto DataGridViewRow.

Valore restituito

Type: System.Int32

Indice della nuova riga.

Exception Condition
ArgumentNullException

values è null.

InvalidOperationException

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

  • Selezione di tutte le celle nel controllo.

  • Annullamento della selezione.

-oppure-

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

-oppure-

La proprietà VirtualMode di DataGridView è impostata su true.

-oppure-

La proprietà DataSource di DataGridView non è null.

-oppure-

DataGridView non contiene colonne.

-oppure-

La riga restituita dalla proprietà DataGridView.RowTemplate contiene più celle rispetto alle colonne nel controllo.

-oppure-

Questa operazione aggiunge una riga bloccata dopo quelle sbloccate.

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

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

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: