DataGridViewRowCollection.IList.Add(Object) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Aggiunge un oggetto DataGridViewRow alla raccolta.

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
int IList.Add (object? value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

Parametri

value
Object

Oggetto Object da aggiungere a IList.

Restituisce

Int32

Indice del nuovo oggetto DataGridViewRow.

Implementazioni

Add(Object)

Eccezioni

InvalidCastException

value non è un oggetto DataGridViewRow.

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.

  • Cancella la 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 value non è null.

-oppure-

Il valore della proprietà Selected di value è true.

-oppure-

Questa operazione aggiunge una riga bloccata dopo quelle sbloccate.

ArgumentNullException

value è null.

ArgumentException

value contiene più celle rispetto alle colonne nel controllo.

Commenti

Questo metodo è un'implementazione esplicita del membro dell'interfaccia. Può essere utilizzato solo quando si esegue il cast dell'istanza DataGridViewRowCollection a un'interfaccia IList.

Questo metodo chiama l'overload Add(DataGridViewRow) , passandolo value dopo il cast in un DataGridViewRowoggetto .

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.

Si applica a

Vedi anche