• Article

Settings.EnableCacheVisualization Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a value that indicates whether to use a non-production analysis visualization mode, which shows areas of a page that are not being GPU accelerated with a colored overlay. Do not use in production code.

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

Syntax

'Declaration
Public Property EnableCacheVisualization As Boolean

public bool EnableCacheVisualization { get; set; }

Property Value

Type: System.Boolean
true if cache visualization is enabled; otherwise, false.

Remarks

During profiling and performance tuning phases of application development, you can set EnableCacheVisualization to true to produce an overlay visualization of the areas in your UI that are being hardware accelerated. You can also set this property in the host HTML on the plug-in level. For more information, see EnableCacheVisualization (Silverlight Plug-in Object).

Important noteImportant Note:

Do not enable cache visualization in production code.

To visualize areas in your UI that are GPU accelerated, you must also enable GPU acceleration and set the cache mode for specific objects. Set EnableGPUAcceleration to true in the host HTML to enable GPU acceleration. For more information, see EnableGPUAcceleration (Silverlight Plug-in Object). You can also set the OutOfBrowserSettings.EnableGPUAcceleration property for out-of-browser applications. For more information, see How to: Configure an Application for Out-of-Browser Support.

To set the cache mode, set the UIElement.CacheMode property on specific objects that might invoke the GPU acceleration path for rendering.

Version Notes

Silverlight for Windows Phone Silverlight for Windows Phone

Colored regions show textures that are passed to the GPU for acceleration in Silverlight for Windows Phone. In the Silverlight browser plug-in for Silverlight for the desktop, colored regions show textures that are not accelerated by the GPU.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.