DataGridViewColumnCollection.IList.Add(Object) Metodo

  • Riferimento

Definizione

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

Aggiunge un oggetto alla fine della raccolta.

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
int IList.Add (object? value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

Parametri

value
Object

Oggetto Object da aggiungere al termine della raccolta. Il valore può essere null.

Restituisce

Int32

Indice in corrispondenza del quale è stato aggiunto value.

Implementazioni

Add(Object)

Eccezioni

InvalidCastException

value non è un oggetto DataGridViewColumn.

ArgumentNullException

value è null.

InvalidOperationException

Il controllo DataGridView associato sta eseguendo una delle azioni riportate di seguito che impedisce temporaneamente di aggiungere nuove colonne:

  • Selezione di tutte le celle nel controllo.

  • Cancellazione della selezione.

  • Aggiornamento dei valori delle proprietà della colonna DisplayIndex .

-oppure-

Questo metodo viene chiamato da un gestore per uno degli eventi di DataGridView seguenti:

-oppure-

La colonna indicata da value appartiene già a un controllo DataGridView.

-oppure-

Il valore della proprietà SortMode della colonna indicata da value è Automatic e il valore della proprietà SelectionMode è FullColumnSelect o ColumnHeaderSelect. Utilizzare i metodi ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() del controllo per impostare temporaneamente i valori delle proprietà in conflitto.

-oppure-

Il valore della proprietà InheritedAutoSizeMode della colonna indicata da value è ColumnHeader e il valore della proprietà ColumnHeadersVisible è false.

-oppure-

La colonna indicata da value ha InheritedAutoSizeMode come valore della proprietà Fill mentre il valore della proprietà Frozen è true.

-oppure-

La colonna indicata da value ha un valore della proprietà FillWeight che fa sì che la somma dei valori di FillWeight di tutte le colonne nel controllo superi 65535.

-oppure-

La colonna indicata da value ha i valori delle proprietà DisplayIndex e Frozen che ne consentono la visualizzazione in un set di colonne adiacenti con il valore della proprietà Frozen opposto.

-oppure-

Il controllo DataGridView contiene almeno una riga e la colonna indicata da value ha null come valore della proprietà CellType.

Commenti

Questo membro è un’implementazione esplicita di un membro di interfaccia. Può essere utilizzato solo quando si esegue il cast dell'istanza DataGridViewColumnCollection a un'interfaccia IList.

Si applica a

Vedi anche