DataGridViewRowCollection.AddCopy(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.
Aggiunge una nuova riga in base alla riga in corrispondenza dell'indice specificato.
public:
virtual int AddCopy(int indexSource);
public virtual int AddCopy (int indexSource);
abstract member AddCopy : int -> int
override this.AddCopy : int -> int
Public Overridable Function AddCopy (indexSource As Integer) As Integer
Parametri
- indexSource
- Int32
Indice della riga su cui basare la nuova riga.
Restituisce
Indice della nuova riga.
Eccezioni
indexSource
è minore di zero o maggiore o uguale al numero di righe nella raccolta.
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-
Questa operazione aggiunge una riga bloccata dopo quelle sbloccate.
Commenti
La InheritedStyle proprietà della nuova riga ha gli stessi valori InheritedStyle della riga posizionata in indexSource
. Il AddCopy 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.