DataGridViewRowCollection.Insert Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Inserisce una o più righe nell'insieme.

Overload

Nome	Descrizione
Insert(Int32, DataGridViewRow)	Inserisce l'oggetto specificato DataGridViewRow nella raccolta.
Insert(Int32, Int32)	Inserisce il numero specificato di righe nella raccolta nella posizione specificata.
Insert(Int32, Object[])	Inserisce una riga nell'insieme nella posizione specificata e popola le celle con gli oggetti specificati.

Insert(Int32, DataGridViewRow)

Origine:

DataGridViewRowCollection.cs

Inserisce l'oggetto specificato DataGridViewRow 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 -> unit

Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

Parametri

rowIndex

Int32

Posizione in corrispondenza della quale inserire la riga.

dataGridViewRow

DataGridViewRow

Oggetto DataGridViewRow da inserire nell'oggetto DataGridViewRowCollection.

Eccezioni

ArgumentOutOfRangeException

rowIndex è minore di zero o maggiore del numero di righe nell'insieme.

ArgumentNullException

dataGridViewRow è null.

InvalidOperationException

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

oppure

La DataSource proprietà di DataGridView non nullè .

oppure

rowIndex è uguale al numero di righe nell'insieme e la AllowUserToAddRows proprietà di DataGridView è impostata su true.

oppure

Non DataGridView dispone di colonne.

oppure

La DataGridView proprietà di dataGridViewRow non nullè .

oppure

dataGridViewRow ha un Selected valore della proprietà pari a true.

oppure

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

ArgumentException

dataGridViewRow contiene più celle di quelle presenti nel controllo .

Commenti

Il Insert(Int32, DataGridViewRow) metodo aggiunge una riga condivisa all'oggetto DataGridViewRowCollection, se possibile. In caso contrario, la nuova riga non è condivisa. 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.

Vedi anche

• DataGridView
• DataGridViewRow

Insert(Int32, Int32)

Origine:

DataGridViewRowCollection.cs

Inserisce il numero specificato di righe nella raccolta nella 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 -> unit

Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

Parametri

rowIndex

Int32

Posizione in corrispondenza della quale inserire le righe.

count

Int32

Numero di righe da inserire nell'oggetto DataGridViewRowCollection.

Eccezioni

ArgumentOutOfRangeException

rowIndex è minore di zero o maggiore del numero di righe nell'insieme.

oppure

count è minore di 1.

InvalidOperationException

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

oppure

La DataSource proprietà di DataGridView non nullè .

oppure

Non DataGridView dispone di colonne.

oppure

rowIndex è uguale al numero di righe nell'insieme e la AllowUserToAddRows proprietà di DataGridView è impostata su true.

oppure

La riga restituita dalla RowTemplate proprietà contiene più celle di quelle presenti nel controllo .

oppure

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

Commenti

Il Insert(Int32, Int32) metodo aggiunge righe basate sull'oggetto dell'oggetto DataGridViewRowTemplate . 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 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.

Vedi anche

• DataGridView
• DataGridViewRow

Insert(Int32, Object[])

Origine:

DataGridViewRowCollection.cs

Inserisce una riga nell'insieme nella 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[] -> unit

Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

Parametri

rowIndex

Int32

Posizione in corrispondenza della quale inserire la riga.

values

Object[]

Numero variabile di oggetti che popolano le celle della nuova riga.

Eccezioni

ArgumentOutOfRangeException

rowIndex è minore di zero o maggiore del numero di righe nell'insieme.

ArgumentNullException

values è null.

InvalidOperationException

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

oppure

La proprietà VirtualMode del DataGridView è impostata su true.

oppure

La DataSource proprietà di DataGridView non nullè .

oppure

Non DataGridView dispone di colonne.

oppure

rowIndex è uguale al numero di righe nell'insieme e la AllowUserToAddRows proprietà di DataGridView è impostata su true.

oppure

La DataGridView proprietà della riga restituita dalla proprietà del RowTemplate controllo non nullè .

oppure

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

ArgumentException

La riga restituita dalla proprietà del RowTemplate controllo ha più celle di quelle presenti nel controllo.

Commenti

Il Insert(Int32, Object[]) metodo aggiunge una riga non condivisa all'oggetto DataGridViewRowCollection.

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