CheckedListBox.ObjectCollection.Add Method (Object, CheckState)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Adds an item to the list of items for a CheckedListBox, specifying the object to add and the initial checked value.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public int Add(
	object item,
	CheckState check


Type: System.Object

An object representing the item to add to the collection.

Type: System.Windows.Forms.CheckState

The initial CheckState for the checked portion of the item.

Return Value

Type: System.Int32

The index of the newly added item.

Exception Condition

The check parameter is not one of the valid CheckState values.

This method adds an item to the checked list box. For an unsorted checked list box, the item is added to the end of the existing list of items. For a sorted checked list box, the item is inserted into the list according to its sorted position. A SystemException occurs if there is insufficient space available to store the new item.

.NET Framework
Available since 1.1
Return to top