DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Metodo

Definizione

Inserisce righe nella raccolta in corrispondenza della posizione specificata.

public:
 virtual void InsertCopies(int indexSource, int indexDestination, int count);
public virtual void InsertCopies (int indexSource, int indexDestination, int count);
abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit
Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)

Parametri

indexSource
Int32

Indice dell'oggetto DataGridViewRow su cui basare le nuove righe.

indexDestination
Int32

Posizione in cui inserire le righe.

count
Int32

Numero di oggetti DataGridViewRowCollection da aggiungere all'oggetto DataGridViewRow.

Eccezioni

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.

-oppure- count è minore di 1.

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

  • Selezione di tutte le celle del controllo.

  • Annullamento della selezione.

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

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

-oppure- Questa operazione inserisce righe bloccate dopo le righe non bloccate oppure righe non bloccate prima delle righe bloccate.

Commenti

La InheritedStyle proprietà dei nuovi oggetti ha gli stessi valori di DataGridViewRow InheritedStyle dell'oggetto DataGridViewRow posizionato in indexSource . Il InsertCopies metodo aggiunge righe condivise all'oggetto , se DataGridViewRowCollection possibile. In caso contrario, le nuove righe vengono annullate. 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 posizione corretta, chiamare DataGridView.Sort il metodo in un gestore DataGridView.RowsAdded eventi. È anche possibile chiamare il metodo in un gestore eventi per ordinare le righe DataGridView.Sort CellValueChanged quando l'utente modifica una cella.

Si applica a

Vedi anche