DataGridViewRowCollection.Insert 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 una o più righe alla raccolta.
Overload
| Insert(Int32, DataGridViewRow) |
Inserisce l'oggetto DataGridViewRow specificato nella raccolta. |
| Insert(Int32, Int32) |
Inserisce il numero di righe specificato nella raccolta in corrispondenza della posizione specificata. |
| Insert(Int32, Object[]) |
Inserisce una riga nella raccolta in corrispondenza della posizione specificata e popola le celle con gli oggetti specificati. |
Insert(Int32, DataGridViewRow)
Inserisce l'oggetto DataGridViewRow specificato nella raccolta.
public:
virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unitPublic Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)Parametri
- rowIndex
- Int32
Posizione in cui inserire la riga.
- dataGridViewRow
- DataGridViewRow
Oggetto DataGridViewRow da inserire in DataGridViewRowCollection.
Eccezioni
rowIndex è minore di zero o maggiore del numero di righe contenute nella raccolta.
dataGridViewRow è null.
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-
rowIndex è 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 dataGridViewRow non è null.
-oppure-
Il valore della proprietà Selected di dataGridViewRow è true.
-oppure-
Questa operazione inserisce una riga bloccata dopo le righe non bloccate oppure una riga non bloccata prima delle righe bloccate.
dataGridViewRow contiene più celle rispetto alle colonne nel controllo.
Commenti
Se possibile, il Insert(Int32, DataGridViewRow) metodo aggiunge una riga condivisa a DataGridViewRowCollection. In caso contrario, la nuova riga non viene 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 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.
Vedi anche
Si applica a
Insert(Int32, Int32)
Inserisce il numero di righe specificato nella raccolta in corrispondenza della posizione specificata.
public:
virtual void Insert(int rowIndex, int count);public virtual void Insert (int rowIndex, int count);abstract member Insert : int * int -> unit
override this.Insert : int * int -> unitPublic Overridable Sub Insert (rowIndex As Integer, count As Integer)Parametri
- rowIndex
- Int32
Posizione in cui inserire le righe.
- count
- Int32
Numero di righe da inserire nell'oggetto DataGridViewRowCollection.
Eccezioni
rowIndex è 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 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-
DataGridView non contiene colonne.
-oppure-
rowIndex è uguale al numero di righe nella raccolta e la proprietà AllowUserToAddRows di DataGridView è impostata su true.
-oppure-
La riga restituita dalla proprietà RowTemplate contiene più celle rispetto alle colonne nel controllo.
-oppure-
Questa operazione inserisce una riga bloccata dopo le righe non bloccate oppure una riga non bloccata prima delle righe bloccate.
Commenti
Il Insert(Int32, Int32) metodo aggiunge righe basate sull'oggetto RowTemplate dell'oggetto DataGridView. La nuova riga viene condivisa, se possibile. Assicurarsi che la riga specificata nella RowTemplate proprietà possa essere condivisa per una migliore scalabilità. 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 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
Si applica a
Insert(Int32, Object[])
Inserisce una riga nella raccolta in corrispondenza della posizione specificata e popola le celle con gli oggetti specificati.
public:
virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);public virtual void Insert (int rowIndex, params object[] values);abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unitPublic Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())Parametri
- rowIndex
- Int32
Posizione in cui inserire la riga.
- values
- Object[]
Numero variabile di oggetti che popolano le celle della nuova riga.
Eccezioni
rowIndex è minore di zero o maggiore del numero di righe contenute nella raccolta.
values è null.
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à VirtualMode del DataGridView è impostata su true.
-oppure-
La proprietà DataSource di DataGridView non è null.
-oppure-
DataGridView non contiene colonne.
-oppure-
rowIndex è uguale al numero di righe nella raccolta e la proprietà AllowUserToAddRows di DataGridView è impostata su true.
-oppure-
La proprietà DataGridView della riga restituita dalla proprietà RowTemplate del controllo non è null.
-oppure-
Questa operazione inserisce una riga bloccata dopo le righe non bloccate oppure una riga non bloccata prima delle righe bloccate.
La riga restituita dalla proprietà RowTemplate contiene più celle rispetto alle colonne nel controllo.
Commenti
Il Insert(Int32, Object[]) metodo aggiunge una riga non condivisa a DataGridViewRowCollection.
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.
