ComboBox.ObjectCollection.Add(Object) ComboBox.ObjectCollection.Add(Object) ComboBox.ObjectCollection.Add(Object) ComboBox.ObjectCollection.Add(Object) Method

Definizione

Aggiunge un elemento all'elenco di elementi per un controllo ComboBox.Adds an item to the list of items for a 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 Object Object Object

Oggetto che rappresenta l'elemento da aggiungere all'insieme.An object representing the item to add to the collection.

Restituisce

Indice con base zero dell'elemento incluso nell'insieme.The zero-based index of the item in the collection.

Implementazioni

Eccezioni

Il valore del parametro item era null.The item parameter was null.

Commenti

Questo metodo aggiunge un elemento alla casella combinata.This method adds an item to the combo box. Se la Sorted proprietà ComboBox di è impostata su true, l'elemento viene inserito nell'elenco in ordine alfabetico.If the Sorted property of the ComboBox is set to true, the item is inserted into the list alphabetically. In caso contrario, l'elemento viene inserito alla fine dell'elenco.Otherwise, the item is inserted at the end of the list.

Una rappresentazione visiva dell'elemento viene visualizzata nella casella combinata.A visual representation of the item is displayed in the combo box. Questa rappresentazione del DisplayMember contenuto viene specificata dalla proprietà.This content representation is specified by the DisplayMember property. Se la DisplayMember proprietà è null, viene chiamato il ToString metodo dell'elemento per ottenere la stringa visualizzata nella casella combinata. in caso contrario, viene visualizzata la proprietà DisplayMember dell'oggetto archiviato come specificato dalla proprietà.If the DisplayMember property is null, the item's ToString method is called to obtain the string that is displayed in the combo box; otherwise, the property of the stored object as specified by the DisplayMember property is displayed. Si SystemException verifica un errore se non è disponibile spazio sufficiente per archiviare il nuovo elemento.A SystemException occurs if there is insufficient space available to store the new item. Per aggiungere un set di elementi alla casella combinata, è preferibile usare il AddRange metodo.To add a set of items to the combo box it is best to use the AddRange method. Se si sceglie di utilizzare il Add metodo per aggiungere un numero di elementi alla casella combinata, utilizzare il BeginUpdate metodo per sospendere la ridisegno durante l'aggiunta e EndUpdate il metodo per riprendere la ridisegno.If you choose to use the Add method to add a number of items to the combo box, use the BeginUpdate method to suspend repainting during your add and the EndUpdate method to resume repainting. È possibile usare il Insert metodo per specificare la posizione nell'elenco in cui viene aggiunto un elemento.You can use the Insert method to specify the location in the list where an item is added. Quando un oggetto viene aggiunto alla raccolta, ComboBox chiama il ToString metodo dell'oggetto per ottenere la stringa da visualizzare nell'elenco.When an object is added to the collection, the ComboBox calls the object's ToString method to obtain the string to display in the list.

Si applica a

Vedi anche