Regex.CacheSize Property

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

Gets or sets the maximum number of entries in the current static cache of compiled regular expressions.

Namespace:  System.Text.RegularExpressions
Assembly:  System (in System.dll)

Syntax

'Declaration
Public Shared Property CacheSize As Integer
public static int CacheSize { get; set; }

Property Value

Type: System.Int32
The maximum number of entries in the static cache.

Exceptions

Exception Condition
ArgumentOutOfRangeException

The value in a set operation is less than zero.

Remarks

The Regex class maintains an internal cache of compiled regular expressions used in static method calls. If the value specified in a set operation is less than the current cache size, cache entries are discarded until the cache size is equal to the specified value.

By default, the cache holds 15 compiled regular expressions. Your application typically will not need to modify the size of the cache. Use the CacheSize property in the rare situation when you need to turn off caching or you have an unusually large cache.

Platform Notes

Silverlight for Windows Phone Silverlight for Windows Phone

 In Silverlight for Windows Phone, the CacheSize property always returns zero because the Regex class implementation does not support caching.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

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

XNA Framework

Supported in: Xbox 360, 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.