This documentation is archived and is not being maintained.
MemoryCache::GetCacheItem Method
Visual Studio 2010
Returns the specified entry from the cache as a CacheItem instance.
Assembly: System.Runtime.Caching (in System.Runtime.Caching.dll)
Parameters
- key
- Type: System::String
A unique identifier for the cache entry to get.
- regionName
- Type: System::String
A named region in the cache to which a cache entry was added. Do not pass a value for this parameter. This parameter is nullptr by default, because the MemoryCache class does not implement regions.
Return Value
Type: System.Runtime.Caching::CacheItemA reference to the cache entry identified by key if the entry exists; otherwise, nullptr.
| Exception | Condition |
|---|---|
| NotSupportedException | regionName is not nullptr. |
| ArgumentNullException | key is nullptr. |
If the cache entry specified by key exists in the cache, the GetCacheItem method returns it as a CacheItem instance. The Key and Value properties of the CacheItem instance will be set. However, the RegionName property will be nullptr, because regions are not implemented in the MemoryCache class.
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: