Condividi tramite

DataGridViewRowCollection.Add Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Aggiunge una o più righe alla raccolta.

Overload

Add()

Aggiunge una nuova riga alla raccolta.
Add(Int32)

Aggiunge il numero specificato di nuove righe alla raccolta.
Add(Object[])

Aggiunge una nuova riga alla raccolta e popola le celle con gli oggetti specificati.
Add(DataGridViewRow)

Aggiunge l'oggetto DataGridViewRow specificato alla raccolta.

Add()

Aggiunge una nuova riga alla raccolta.

public:
 virtual int Add();
public virtual int Add ();
abstract member Add : unit -> int
override this.Add : unit -> int
Public Overridable Function Add () As Integer

Restituisce

Int32

Indice della nuova riga.

Eccezioni

InvalidOperationException

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-

Questa operazione aggiunge una riga bloccata dopo quelle sbloccate.

ArgumentException

La riga restituita dalla proprietà RowTemplate contiene più celle rispetto alle colonne nel controllo.

Commenti

L'overload Add() 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

Add(Int32)

Aggiunge il numero specificato di nuove righe alla raccolta.

public:
 virtual int Add(int count);
public virtual int Add (int count);
abstract member Add : int -> int
override this.Add : int -> int
Public Overridable Function Add (count As Integer) As Integer

Parametri

count
Int32

Numero di righe da aggiungere a DataGridViewRowCollection.

Restituisce

Int32

Indice dell'ultima riga aggiunta.

Eccezioni

ArgumentOutOfRangeException

count è minore di 1.

InvalidOperationException

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-

La riga restituita dalla proprietà RowTemplate contiene più celle rispetto alle colonne nel controllo.

-oppure-

Questa operazione aggiunge righe bloccate dopo le righe non bloccate.

Commenti

Il Add(Int32) metodo aggiunge righe condivise all'oggetto DataGridViewRowCollection. Le nuove righe sono basate sull'oggetto RowTemplate dell'oggetto DataGridView. 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

Add(Object[])

Aggiunge una nuova riga alla raccolta e popola le celle con gli oggetti specificati.

public:
 virtual int Add(... cli::array <System::Object ^> ^ values);
public virtual int Add (params object[] values);
abstract member Add : obj[] -> int
override this.Add : obj[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer

Parametri

values
Object[]

Numero variabile di oggetti che popolano le celle del nuovo oggetto DataGridViewRow.

Restituisce

Int32

Indice della nuova riga.

Eccezioni

ArgumentNullException

values è null.

InvalidOperationException

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-

La riga restituita dalla proprietà RowTemplate contiene più celle rispetto alle colonne nel controllo.

-oppure-

Questa operazione aggiunge una riga bloccata dopo quelle sbloccate.

Commenti

Il Add(Object[]) metodo aggiunge una riga non condivisa a DataGridViewRowCollection. 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

Add(DataGridViewRow)

Aggiunge l'oggetto DataGridViewRow specificato alla raccolta.

public:
 virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int
Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

Parametri

dataGridViewRow
DataGridViewRow

Oggetto DataGridViewRow da aggiungere a DataGridViewRowCollection.

Restituisce

Int32

Indice del nuovo oggetto DataGridViewRow.

Eccezioni

InvalidOperationException

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-

La proprietà DataGridView di dataGridViewRow non è null.

-oppure-

Il valore della proprietà Selected di dataGridViewRow è true.

-oppure-

Questa operazione aggiunge una riga bloccata dopo quelle sbloccate.

ArgumentNullException

dataGridViewRow è null.

ArgumentException

dataGridViewRow contiene più celle rispetto alle colonne nel controllo.

Commenti

Se possibile, il Add(DataGridViewRow) metodo aggiunge una riga condivisa a DataGridViewRowCollection. 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.

Vedi anche

Si applica a