ComboBox.ObjectCollection.Add(Object) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje element do listy elementów dla elementu 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

Parametry

item

Object

Obiekt reprezentujący element, który ma zostać dodany do kolekcji.

Zwraca

Int32

Indeks oparty na zerowym elemencie w kolekcji.

Wyjątki

ArgumentNullException

Parametr item to null.

Uwagi

Ta metoda dodaje element do pola kombi. Sorted Jeśli właściwość ComboBox jest ustawiona na true, element zostanie wstawiony do listy alfabetycznie. W przeciwnym razie element zostanie wstawiony na końcu listy.

Wizualna reprezentacja elementu jest wyświetlana w polu kombi. Ta reprezentacja zawartości jest określana przez DisplayMember właściwość . DisplayMember Jeśli właściwość to null, metoda elementu ToString jest wywoływana w celu uzyskania ciągu wyświetlanego w polu kombi. W przeciwnym razie właściwość przechowywanego obiektu określona przez DisplayMember właściwość jest wyświetlana. Występuje SystemException , jeśli za mało miejsca do przechowywania nowego elementu. Aby dodać zestaw elementów do pola kombi, najlepiej użyć AddRange metody . Jeśli zdecydujesz się użyć Add metody w celu dodania wielu elementów do pola kombi, użyj BeginUpdate metody , aby wstrzymać ponowne malowanie podczas dodawania i EndUpdate metodę w celu wznowienia ponownego malowania. Możesz użyć Insert metody , aby określić lokalizację na liście, w której jest dodawany element. Po dodaniu obiektu do kolekcji ComboBox obiekt wywołuje metodę obiektu ToString w celu uzyskania ciągu do wyświetlenia na liście.

Zobacz też

• IList