ComboBox.ObjectCollection.IList.Add(Object) Метод

Определение

Описание этого члена см. в разделе Add(Object).For a description of this member, see Add(Object).

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

Параметры

item
Object

Объект, представляющий элемент для добавления в коллекцию.An object that represents the item to add to the collection.

Возвращаемое значение

Int32

Отсчитываемый от нуля индекс элемента в коллекции.The zero-based index of the item in the collection.

Реализации

Исключения

Параметр item имеет значение null.The item parameter is null.

Недостаточно места для сохранения нового элемента.There is insufficient space available to store the new item.

Комментарии

Этот член представляет собой явную реализацию члена интерфейса.This member is an explicit interface member implementation. Он может использоваться, только если экземпляр ComboBox.ObjectCollection приведен к типу интерфейса IList.It can be used only when the ComboBox.ObjectCollection instance is cast to an IList interface.

Этот метод добавляет элемент в поле со списком.This method adds an item to the combo box. Если Sorted свойство объекта ComboBox имеет значение true , элемент вставляется в список в алфавитном порядке.If the Sorted property of the ComboBox is set to true, the item is inserted into the list alphabetically. В противном случае элемент вставляется в конец списка.Otherwise, the item is inserted at the end of the list.

Визуальное представление элемента отображается в поле со списком.A visual representation of the item is displayed in the combo box. Это представление содержимого определяется DisplayMember свойством.This content representation is specified by the DisplayMember property. Если DisplayMember свойство имеет значение null , ToString вызывается метод элемента для получения строки, отображаемой в поле со списком; в противном случае отображается свойство сохраненного объекта, как указано DisplayMember свойством.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. Чтобы добавить набор элементов в поле со списком, лучше использовать AddRange метод.To add a set of items to the combo box, it is best to use the AddRange method. Если вы решили использовать Add метод для добавления набора элементов в поле со списком, используйте BeginUpdate метод для приостановки перерисовки во время добавления и EndUpdate метода, чтобы возобновить перерисовку.If you choose to use the Add method to add a set of items to the combo box, use the BeginUpdate method to suspend repainting during your add and the EndUpdate method to resume repainting. С помощью метода можно Insert указать расположение в списке, куда добавляется элемент.You can use the Insert method to specify the location in the list where an item is added. При добавлении объекта в коллекцию ComboBox вызывает ToString метод объекта для получения строки, отображаемой в списке.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.

Применяется к

См. также раздел