DataGridViewRowCollection.IList.Insert(Int32, Object) Metodo

  • Riferimento

Definizione

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

Inserisce un oggetto DataGridViewRow nella raccolta in corrispondenza dell'indice specificato.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
void IList.Insert (int index, object? value);
abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit
Sub Insert (index As Integer, value As Object) Implements IList.Insert

Parametri

index
Int32

Indice in base zero nel quale value deve essere inserito.

value
Object

Oggetto DataGridViewRow da inserire in DataGridViewRowCollection.

Implementazioni

Insert(Int32, Object)

Eccezioni

InvalidCastException

value non è un oggetto DataGridViewRow.

ArgumentOutOfRangeException

index è minore di zero o maggiore del numero di righe contenute nella raccolta.

ArgumentNullException

value è 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.

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

index è uguale al numero di righe nella raccolta e la proprietà AllowUserToAddRows di DataGridView è impostata su true.

-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 inserisce una riga bloccata dopo le righe non bloccate oppure una riga non bloccata prima delle righe bloccate.

ArgumentException

value contiene più celle rispetto alle colonne nel controllo.

Commenti

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

Questo metodo chiama l'overload Insert(Int32, DataGridViewRow) , passando il valore dopo il cast a un oggetto DataGridViewRow.

Le righe nel controllo non vengono ordinate automaticamente quando vengono aggiunte nuove righe. Per ordinare le 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