DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 corrispondenza della quale inserire le righe.
- count
- Int32
Numero di DataGridViewRow oggetti da aggiungere all'oggetto DataGridViewRowCollection.
Eccezioni
indexSource è minore di zero o maggiore del numero di righe nell'insieme meno uno.
oppure
indexDestination è minore di zero o maggiore del numero di righe nell'insieme.
oppure
count è minore di 1.
Il controllo associato DataGridView esegue 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 seguenti DataGridView :
oppure
indexDestination è uguale al numero di righe nell'insieme e AllowUserToAddRows è true.
oppure
Questa operazione inserisce righe bloccate dopo le righe non bloccate o le righe non bloccate prima delle righe bloccate.
Commenti
La InheritedStyle proprietà dei nuovi DataGridViewRow oggetti ha gli stessi valori InheritedStyle di dell'oggetto DataGridViewRow posizionato in indexSource. Il InsertCopies metodo aggiunge righe condivise all'oggetto DataGridViewRowCollection, se possibile. In caso contrario, le nuove righe non vengono condivise. Per altre informazioni, vedere Procedure consigliate per il ridimensionamento del controllo DataGridView di 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.