Retrieves the specified item from the Cache object.

Namespace: Alachisoft.NCache.Web.Caching
Assembly: Alachisoft.NCache.Web (in Alachisoft.NCache.Web.dll) Version: 4.1.0.0 (4.1.0.0)

Syntax

C#
public virtual CacheItem GetCacheItem( string key, DSReadOption dsReadOption )

Visual Basic
Public Overridable Function GetCacheItem ( _ key As String, _ dsReadOption As DSReadOption _ ) As CacheItem

Visual C++
public: virtual CacheItem^ GetCacheItem( String^ key, DSReadOption dsReadOption )

key: Type: System..::..String
The identifier for the cache item to retrieve.

dsReadOption: Type: Alachisoft.NCache.Web.Caching..::..DSReadOption
Options regarding reading from data source

The retrieved cache item, or a null reference (Nothing in Visual Basic) if the key is not found.

Remarks

Note: If exceptions are enabled through the ExceptionsEnabled setting, this property throws exception incase of failure.

The following example demonstrates how to retrieve the value cached for an ASP.NET text box server control.

CopyC#

Cache cache = NCache.InitializeCache("myCache");
string textBoxValue = (string) cache.Get("MyTextBox.Value", DSReadOption.ReadThru);

Exception	Condition
System..::..ArgumentNullException	key contains a null reference (Nothing in Visual Basic).
System..::..ArgumentException	key is not serializable.