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 (DataGridViewRow)

 

Data di pubblicazione: ottobre 2016

Aggiunge l'oggetto DataGridViewRow specificato alla raccolta.

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

public virtual int Add(
	DataGridViewRow dataGridViewRow
)

Parametri

dataGridViewRow
Type: System.Windows.Forms.DataGridViewRow

Oggetto DataGridViewRow da aggiungere a DataGridViewRowCollection.

Valore restituito

Type: System.Int32

Indice del nuovo oggetto DataGridViewRow.

Exception Condition
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à DataSource di DataGridView non è null.

-oppure-

DataGridView non contiene colonne.

-oppure-

La proprietà DataGridView di dataGridViewRow non è null.

-oppure-

Il valore della proprietà Selected di dataGridViewRow è true.

-oppure-

Questa operazione aggiunge una riga bloccata dopo quelle sbloccate.

ArgumentNullException

dataGridViewRow è null.

ArgumentException

dataGridViewRow contiene più celle rispetto alle colonne nel controllo.

Il Add(DataGridViewRow) metodo aggiunge una riga condivisa per il DataGridViewRowCollection, se possibile. In caso contrario, la nuova riga verrà annullata. 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: