DataGridViewRowCollection.InsertCopy(Int32, Int32) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Inserisce una riga nella raccolta nella posizione specificata, in base alla riga in corrispondenza della posizione specificata.

public:
 virtual void InsertCopy(int indexSource, int indexDestination);

public virtual void InsertCopy (int indexSource, int indexDestination);

abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unit

Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)

Parametri

indexSource

Int32

Indice della riga su cui basare la nuova riga.

indexDestination

Int32

Posizione in cui inserire la riga.

Eccezioni

ArgumentOutOfRangeException

indexSource è minore di zero oppure maggiore del numero di righe contenute nella raccolta meno uno.

-oppure-

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

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:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-oppure-

indexDestination è uguale al numero di righe nella raccolta e la proprietà AllowUserToAddRows è true.

-oppure-

Questa operazione inserisce una riga bloccata dopo le righe non bloccate oppure una riga non bloccata prima delle righe bloccate.

Commenti

Questo metodo assegna la nuova riga specificata nel indexDestination parametro e incrementa gli indici per tutte le righe successive. La InheritedStyle proprietà del nuovo DataGridViewRow ha gli stessi valori dell'oggetto InheritedStyleDataGridViewRow posizionato in indexSource. Il InsertCopy metodo aggiunge una riga condivisa a DataGridViewRowCollection, se possibile. In caso contrario, la nuova riga non è condivisa. 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 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