This documentation is archived and is not being maintained.

ListView.VirtualListSize Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the number of ListViewItem objects contained in the item cache when in virtual mode.

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

property int VirtualListSize {
	int get ();
	void set (int value);
/** @property */
public int get_VirtualListSize ()

/** @property */
public void set_VirtualListSize (int value)

public function get VirtualListSize () : int

public function set VirtualListSize (value : int)

Property Value

The number of ListViewItem objects contained in the ListView when in virtual mode.

Exception typeCondition


VirtualListSize is set to a value less than 0.


VirtualMode is set to true, VirtualListSize is greater than 0, and RetrieveVirtualItem is not handled.

Getting or setting the VirtualListSize property when VirtualMode set to false will have no effect on the ListView.

If VirtualMode is set to true, and the VirtualListSize property is greater than 0, you must handle the RetrieveVirtualItem event, providing a valid ListViewItem.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0