DataGridRowsPresenter.OnCleanUpVirtualizedItem Method (CleanUpVirtualizedItemEventArgs)

.NET Framework (current version)
 
System_CAPS_noteNote

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

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 NIB: 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
Available since 4.0
Return to top
Show: