DataCache::Put Method (String^, Object^, TimeSpan, IEnumerable<DataCacheTag^>^)
Adds or replaces an object in the cache. Specifies the timeout value and associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.
Assembly: Microsoft.ApplicationServer.Caching.Client (in Microsoft.ApplicationServer.Caching.Client.dll)
public: DataCacheItemVersion^ Put( String^ key, Object^ value, TimeSpan timeout, IEnumerable<DataCacheTag^>^ tags )
Parameters
- key
-
Type:
System::String^
The unique value that is used to identify the object in the cache. Key names must be less than 65 KB.
- value
-
Type:
System::Object^
The object to add or replace.
- timeout
-
Type:
System::TimeSpan
The amount of time that the object should reside in the cache before expiration.
- tags
-
Type:
System.Collections.Generic::IEnumerable<DataCacheTag^>^
A list of tags to associate with the object.
Return Value
Type: Microsoft.ApplicationServer.Caching::DataCacheItemVersion^A DataCacheItemVersion object that represents the version of the object saved to the cache under the key value.
Tags may only be used to retrieve a cached object if that object is stored in a region. This overload does not store the object in a region.
The timeout value associated with the cached object overrides expiration settings specified in the named cache configuration.