ComboBox.ObjectCollection.Add(Object) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Aggiunge un elemento all'elenco di elementi per un controllo ComboBox.

public:
 int Add(System::Object ^ item);

public int Add (object item);

member this.Add : obj -> int

Public Function Add (item As Object) As Integer

Parametri

item

Object

Oggetto che rappresenta l'elemento da aggiungere all'insieme.

Restituisce

Int32

Indice in base zero dell'elemento nella raccolta.

Eccezioni

ArgumentNullException

Il valore del parametro item era null.

Commenti

Questo metodo aggiunge un elemento alla casella combinata. Se la Sorted proprietà di ComboBox è impostata su true, l'elemento viene inserito nell'elenco in ordine alfabetico. In caso contrario, l'elemento viene inserito alla fine dell'elenco.

Nella casella combinata viene visualizzata una rappresentazione visiva dell'elemento. Questa rappresentazione di contenuto viene specificata dalla DisplayMember proprietà . Se la DisplayMember proprietà è null, viene chiamato il metodo dell'elemento ToString per ottenere la stringa visualizzata nella casella combinata. In caso contrario, viene visualizzata la proprietà dell'oggetto archiviato come specificato dalla DisplayMember proprietà . Si SystemException verifica se non è disponibile spazio sufficiente per archiviare il nuovo elemento. Per aggiungere un set di elementi alla casella combinata, è consigliabile usare il AddRange metodo . Se si sceglie di utilizzare il metodo per aggiungere un numero di elementi alla casella combinata, utilizzare il metodo per sospendere l'aggiornamento durante l'aggiunta Add e il metodo per riprendere l'aggiornamentoEndUpdate.BeginUpdate È possibile utilizzare il Insert metodo per specificare il percorso nell'elenco in cui viene aggiunto un elemento. Quando un oggetto viene aggiunto all'insieme, ComboBox chiama il metodo dell'oggetto ToString per ottenere la stringa da visualizzare nell'elenco.

Vedi anche

• IList