This documentation is archived and is not being maintained.

ListViewItem Constructor (ListViewItem.ListViewSubItem[], String, ListViewGroup)

Initializes a new instance of the ListViewItem class with the specified subitems, image, and group.

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

public ListViewItem(
	ListViewItem..::..ListViewSubItem[] subItems,
	string imageKey,
	ListViewGroup group


Type: System.Windows.Forms.ListViewItem.ListViewSubItem[]
An array of ListViewItem.ListViewSubItem objects that represent the subitems of the ListViewItem.
Type: System.String
The name of the image within the ImageList of the owning ListView to display in the item.
Type: System.Windows.Forms.ListViewGroup
The ListViewGroup to assign the item to.

This version of the constructor is useful when you create ListViewItem.ListViewSubItem objects before adding them to a ListViewItem (for example, to indicate special formatting or to use the subitems in multiple items). It also allows you to specify the group to which an item belongs.

The imageKey parameter specifies an image in the ImageList associated with the owning ListView control, which can be accessed with the ImageList property.


ListView groups are only available on Windows XP and the Windows Server 2003 family (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). For more information, see the ListViewGroup overview topic.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.