This documentation is archived and is not being maintained.

DataGridRowsPresenter.OnCleanUpVirtualizedItem Method

Raises the CleanUpVirtualizedItem event for rows that have scrolled out of view.

Namespace:  System.Windows.Controls.Primitives
Assembly:  PresentationFramework (in PresentationFramework.dll)

protected override void OnCleanUpVirtualizedItem(
	CleanUpVirtualizedItemEventArgs e
)

By default, the DataGridRowsPresenter class maintains DataGridRow instances only for data items that are currently on display within the user interface. When rows are scrolled out of view, the DataGridRow instances become available for garbage collection.

This OnCleanUpVirtualizedItem method override cancels cleanup for rows that have validation errors. You can override this method or handle the CleanUpVirtualizedItem event to provide your own logic for canceling the cleanup of particular rows.

Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

The OnCleanUpVirtualizedItem method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors

When overriding OnCleanUpVirtualizedItem in a derived class, make sure to call the base class’s OnCleanUpVirtualizedItem method so that registered delegates receive the event.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, 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.
Show: