ListView.ListViewItemCollection.Add Method (String, String, Int32)

 

Creates an item with the specified key, text, and image and adds an item to the collection.

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

public virtual ListViewItem Add(
	string key,
	string text,
	int imageIndex
)

Parameters

key
Type: System.String

The name of the item.

text
Type: System.String

The text of the item.

imageIndex
Type: System.Int32

The index of the image to display for the item.

Return Value

Type: System.Windows.Forms.ListViewItem

The ListViewItem added to the collection.

Exception Condition
InvalidOperationException

The containing ListView is in virtual mode.

If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. The Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

The Add method sets the Name property to the specified key, so the item can be retrieved by its index or by key.

.NET Framework
Available since 2.0
Return to top
Show: