<summary>The object that is used by cache-enabled applications for storing and retrieving objects from the cache. An instance of this object is referred to as the cache client.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds an object to the cache. This method enables associating tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds an object to a region in the cache. This method enables association of tags with objects in the cache. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds an object to a region in the cache. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds an object to the cache. This method provides the ability to specify when the object should be expired.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds an object to the cache. This method enables associating tags with the cached object and specifying when the object should be expired. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds an object to a region in the cache. This method enables associating tags with the cached object and specifying when the object should be expired. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds an object to a region in the cache. This method provides the ability to specify when the object should be expired. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/>object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds a bulk cache notification callback for cache operations occurring on all regions and items. Not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object used to identify the cache bulk notification callback.</returns>
<paramname="clientCallback">The name of the method you want to invoke when these notifications occur.</param>
<summary>Adds a cache notification callback for cache operations occurring on all regions and items. Not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object used to identify the cache notification callback.</returns>
<paramname="filter">The type of cache operation(s) that will trigger cache notifications.</param>
<paramname="clientCallback">The name of the method you want to invoke when these notifications occur.</param>
<summary>Adds a failure notification callback, for notifications indicating that a client has missed one or more cache notifications. Not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object used to identify the cache notification callback.</returns>
<paramname="failureCallback">The name of the method that you want to invoke when the failure notification occurs.</param>
<summary>Adds a cache notification callback for cache operations occurring on one specific item that is not stored in a region. Not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object used to identify the cache notification callback.</returns>
<paramname="key">The key used to store the object in the cache.</param>
<paramname="filter">The type of cache operation(s) that will trigger cache notifications.</param>
<paramname="clientCallback">The name of the method you want to invoke when these notifications occur.</param>
<summary>Adds a cache notification callback for cache operations occurring on one specific item that is stored in region. Not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object used to identify the cache notification callback.</returns>
<paramname="key">The key used to store the object in the cache.</param>
<paramname="filter">The type of cache operation(s) that will trigger cache notifications.</param>
<paramname="clientCallback">The name of the method you want to invoke when these notifications occur.</param>
<paramname="region">The name of the region where the object is stored.</param>
<summary>Adds a cache notification callback for cache operations occurring on one specific region. Not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object used to identify the cache notification callback.</returns>
<paramname="region">The name of the region for which the specified item or region operations can trigger cache notifications.</param>
<paramname="filter">The type of cache operation(s) that will trigger cache notifications.</param>
<paramname="clientCallback">The name of the method you want to invoke when these notifications occur.</param>
<summary>Gets all of the objects associated with the specified keys across all system regions. This method does not search user-defined regions.</summary>
<returns>Returns an <seecref="T:System.Collections.Generic.IEnumerable`1"/> object with a list of key and value pairs.</returns>
<paramname="keys">List of keys for the objects to retrieve, cannot be null.</param>
<summary>Gets an object from the cache using the specified key. You may also provide the version to obtain a specific version of a key, if that version is still the most current in the cache.</summary>
<returns>The object that was cached by using the specified key. Null is returned if the key does not exist. Even if the key does exist, Null may also be returned because the object has been updated to a new version.</returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<paramname="version">The version of the desired object. If this parameter is null, the version of the current object is retrieved.</param>
<summary>Gets an object from the specified region by using the specified key. You may also provide the version to obtain the specific version of a key, if that version is still the most current in the region. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>The object that was cached by using the specified key. Null is returned if the key does not exist. Even if the key does exist, Null may also be returned because the object has been updated to a new version.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="version">The version of the desired object. If this parameter is null, the version of the current object is retrieved.</param>
<paramname="region">The name of the region where the object resides.</param>
<summary>Gets an object from the specified region by using the specified key. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>The object that was cached by using the specified key. Null is returned if the key does not exist.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="region">The name of the region where the object resides.</param>
<summary>Locks the key if the key is present and it is not locked and returns the object corresponding to the key.</summary>
<returns>Returns <seecref="T:System.Object"/> matching the specified <paramrefname="key"/> parameter if the <seecref="T:System.Object"/> is present and is not locked. If the key does not exist, a DataCacheException object is thrown with the ErrorCode set to <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheErrorCode.KeyDoesNotExist"/>. Create objects based on the referenced key to resolve this error.If the object is already locked by another cache client, a DataCacheException object is thrown with the ErrorCode set to <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheErrorCode.ObjectLocked"/>. The object will be inaccessible until it is unlocked by the locking client.</returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<paramname="timeout">The amount of time that the object should remain locked.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object required to unlock the object. The <paramrefname="lockHandle"/> output parameter is passed by reference.</param>
<summary>Lock the key if key is present and it is not locked by any clients and returns the object corresponding to the key.</summary>
<returns>Returns <seecref="T:System.Object"/> matching the specified <paramrefname="key"/> parameter if the <seecref="T:System.Object"/> is present and is not locked. If the key does not exist, a DataCacheException object is thrown with the ErrorCode set to <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheErrorCode.KeyDoesNotExist"/>. Create objects based on the referenced key to resolve this error.If the object is already locked by another cache client, a DataCacheException object is thrown with the ErrorCode set to <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheErrorCode.ObjectLocked"/>. The object will be inaccessible until it is unlocked by the locking client.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="timeout">The amount of time that object remains locked.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object required to unlock the object. The <paramrefname="lockHandle"/> output parameter is passed by reference.</param>
<paramname="forceLock">If forceLock is true, key is locked irrespective of key-value pair presence in cache.</param>
<summary>Locks the key if the key is present and is not locked and returns the object corresponding to the key. For objects stored in regions. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>Returns <seecref="T:System.Object"/> matching the specified <paramrefname="key"/> parameter if the <seecref="T:System.Object"/> is present and is not locked.If the key does not exist, a DataCacheException object is thrown with the ErrorCode set to <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheErrorCode.KeyDoesNotExist"/>. Create objects based on the referenced key to resolve this error.If the object is already locked by another cache client, a DataCacheException object is thrown with the ErrorCode set to <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheErrorCode.ObjectLocked"/>. The object will be inaccessible until it is unlocked by the locking client.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="timeout">The amount of time that the object remains locked.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object required to unlock the object. The <paramrefname="lockHandle"/> output parameter is passed by reference.</param>
<paramname="region">The name of the region where the object resides.</param>
<summary>Lock the key if key is present and it is not locked by any clients and returns the object corresponding to the key. For objects stored in regions. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>Returns <seecref="T:System.Object"/> matching the specified <paramrefname="key"/> parameter if the <seecref="T:System.Object"/> is present and is not locked.If the key does not exist, a DataCacheException object is thrown with the ErrorCode set to <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheErrorCode.KeyDoesNotExist"/>. Create objects based on the referenced key to resolve this error.If the object is already locked by another cache client, a DataCacheException object is thrown with the ErrorCode set to <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheErrorCode.ObjectLocked"/>. The object will be inaccessible until it is unlocked by the locking client.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="timeout">The amount of time that the object remains locked.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object required to unlock the object. The <paramrefname="lockHandle"/> output parameter is passed by reference.</param>
<paramname="region">The name of the region where the object resides.</param>
<paramname="forceLock">If forceLock is true, key is locked irrespective of key-value pair presence in cache.</param>
<summary>Gets a <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItem"/> object to retrieve all information associated with your cached object in the cluster.</summary>
<returns>A<seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItem"/> object that contains all information associated with your cached object. Null is returned if the key does not exist.</returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<summary>Gets a <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItem"/> object to retrieve all information associated with your cached object in the cluster. For objects stored in regions. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItem"/> object that contains all information associated with your cached object. Null is returned if the key does not exist.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="region">The name of the region where the object resides.</param>
<summary>Gets an object from the cache, but only if a newer version of the object resides in the cache.</summary>
<returns>If the version in the cache differs from the version parameter, the corresponding cached object is returned. If the version in the cache is the same as the version parameter, null is returned.</returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<paramname="version">The version of the desired object, passed by reference.</param>
<summary>Gets an object from the specified region, but only if a newer version of the object resides in the region. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>If the version in the region differs from the version parameter, the corresponding cached object is returned. If the version in the region is the same as the version parameter, null is returned.</returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<paramname="version">The version of the desired object, passed by reference.</param>
<paramname="region">The name of the region where the object resides.</param>
<summary>Gets an enumerable list of all cached objects in the specified region that have all the same tags in common. Not supported in Windows Azure Shared Caching.</summary>
<returns>An enumerable list of all cached objects in the specified region that have all the same tags in common.</returns>
<paramname="tags">A list of tags for which to search.</param>
<paramname="region">The name of the region to search. Tags are not supported outside regions. Therefore, a region name is required.</param>
<summary>Gets an enumerable list of all cached objects in the specified region that have any of the same tags in common. Not supported in Windows Azure Shared Caching.</summary>
<returns>An enumerable list of all cached objects in the specified region that have any of the same tags in common. Null is returned if no objects in the specified region have any of the tags specified.</returns>
<paramname="tags">A list of tags for which to search.</param>
<paramname="region">The name of the region to search. Tags are not supported outside regions. Therefore, a region name is required.</param>
<summary>Gets an enumerable list of all cached objects in the specified region that have the specified tag. Not supported in Windows Azure Shared Caching.</summary>
<returns>An enumerable list of all cached objects in the specified region that have the specified tag. Null is returned if no objects in the specified region have the tag specified.</returns>
<paramname="tag">The tag for which to search.</param>
<paramname="region">The name of the region to search. Tags are not supported outside regions. Therefore, a region name is required.</param>
<summary>Adds or replaces an object in the cache.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds or replaces an object in the cache if it is at the specified version.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<paramname="value">The object to add or replace.</param>
<paramname="oldVersion">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be replaced.</param>
<summary>Adds or replaces an object in the cache if it is at the specified version. Associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<paramname="value">The object to add or replace.</param>
<paramname="oldVersion">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be replaced.</param>
<paramname="tags">A list of tags to associate with the object.</param>
<summary>Adds or replaces an object in the specified region if it is at the specified version. Associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<paramname="value">The object to add or replace.</param>
<paramname="oldVersion">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be replaced.</param>
<paramname="tags">A list of tags to associate with the object.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Adds or replaces an object in the specified region if it is at the specified version. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<paramname="value">The object to add or replace.</param>
<paramname="oldVersion">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be replaced.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Adds or replaces an object in the cache if it is at the specified version. Specifies the timeout value of the cached object.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<paramname="value">The object to add or replace.</param>
<paramname="oldVersion">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be replaced.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<summary>Adds or replaces an object in the cache if it is at the specified version. Specifies the timeout value and associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<paramname="value">The object to add or replace.</param>
<paramname="oldVersion">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be replaced.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<paramname="tags">A list of tags to associate with the object.</param>
<summary>Adds or replaces an object in the specified region if it is at the specified version. Specifies the timeout value and associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<paramname="value">The object to add or replace.</param>
<paramname="oldVersion">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be replaced.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<paramname="tags">A list of tags to associate with the object.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Adds or replaces an object in the specified region if it is at the specified version. Specifies the timeout value of the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<paramname="value">The object to add or replace.</param>
<paramname="oldVersion">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be replaced.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Adds or replaces an object in the cache. Associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the key value.</returns>
<summary>Adds or replaces an object in the specified region. Associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<summary>Adds or replaces an object in the specified region. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<summary>Adds or replaces an object in the cache. Specifies the timeout value of the cached object.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<summary>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.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<summary>Adds or replaces an object in the specified region. Specifies the timeout value and associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<summary>Adds or replaces an object in the specified region. Specifies the timeout value of the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the object saved to the cache under the <paramrefname="key"/> value.</returns>
<paramname="key">Adds or replaces an object in the specified region. Specifies the timeout value of the cached object. Key names must be less than 65 KB.</param>
<summary>Replaces and unlocks an object in the cache.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object after it has been updated by this method. </returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<paramname="value">The object to add or replace.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<summary>Replaces and unlocks an object in the cache. Associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object after it has been updated by this method.</returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<paramname="value">The object to add or replace.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="tags">A list of tags to associate with the object.</param>
<summary>Replaces and unlocks an object in the specified region. Associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object after it has been updated by this method.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="value">The object to add or replace.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="tags">A list of tags to associate with the object.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Replaces and unlocks an object in the specified region. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object after it has been updated by this method.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="value">The object to add or replace.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Replaces and unlocks an object in the cache. Specifies the timeout value of the cached object.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object after it has been updated by this method.</returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<paramname="value">The object to add or replace.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<summary>Replaces and unlocks 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.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object after it has been updated by this method.</returns>
<paramname="key">The unique value that is used to identify the object in the cache.</param>
<paramname="value">The object to add or replace.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<paramname="tags">A list of tags to associate with the object.</param>
<summary>Replaces and unlocks an object in the specified region. Specifies the timeout value and associates tags with the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object after it has been updated by this method.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="value">The object to add or replace.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<paramname="tags">A list of tags to associate with the object.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Replaces and unlocks an object in the specified region. Specifies the timeout value of the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object after it has been updated by this method. The timeout value associated with the cached object overrides expiration settings specified in the named cache configuration.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="value">The object to add or replace.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Removes an object with a specific version from the cache.</summary>
<returns>True if the object is removed; otherwise, false.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="version">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be removed.</param>
<summary>Removes an object with a specific version from the cache in a region. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>True if the object is removed; otherwise, false.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="version">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> object that represents the version of the cached object that is to be removed.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Removes an object from the cache with an associated lock handle in a region. This overload is not supported in Windows Azure Shared Caching.</summary>
<returns>True if the object is removed; otherwise, false.</returns>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="lockHandle">The object that was returned when the object was removed.</param>
<paramname="region">The name of the region the object resides in.</param>
<summary>Resets the object timeout value, defining how long objects reside in the cache before expiring. The value specified for the object overrides the default settings for the cache.</summary>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="newTimeout">The amount of time that the object should reside in the cache before expiration.</param>
<summary>Resets the object timeout value, defining how long objects reside in the region before expiring. The value specified for the object overrides the default settings for the cache.</summary>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="newTimeout">The amount of time that the object should reside in the cache before expiration.</param>
<paramname="region">The name of the region where the object resides.</param>
<summary>Releases objects locked in the cache. This method supports pessimistic concurrency by making sure that the appropriate DataCacheLockHandle is used for unlocking the object.</summary>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked</param>
<summary>Releases objects locked in the specified region. This method supports pessimistic concurrency by making sure that the appropriate DataCacheLockHandle is used for unlocking the object. This overload is not supported in Windows Azure Shared Caching.</summary>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="region">The name of the region where the object resides.</param>
<summary>Releases objects locked in the cache. This method supports pessimistic concurrency by making sure that the appropriate DataCacheLockHandle is used for unlocking the object. Specifies a new timeout value for the cached object.</summary>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<summary>Releases objects locked in the specified region. This method supports pessimistic concurrency by making sure that the appropriate DataCacheLockHandle is used for unlocking the object. Specifies a new timeout value for the cached object. This overload is not supported in Windows Azure Shared Caching.</summary>
<paramname="key">The unique value that is used to identify the object in the region.</param>
<paramname="lockHandle">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLockHandle"/> object that was returned when the object was locked.</param>
<paramname="timeout">The amount of time that the object should reside in the cache before expiration.</param>
<paramname="region">The name of the region where the object resides.</param>
<summary>Specifies a callback which is called with a list of cache operations. Not supported in Windows Azure Shared Caching.</summary>
<paramname="cacheName">The name of the cache where the object is stored.</param>
<paramname="operations">A list of <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> cache operations.</param>
<paramname="nd">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> associated with the cache notification that invoked the delegate method.</param>
<summary>Provides methods to return <seecref="T:Microsoft.ApplicationServer.Caching.DataCache"/> objects that are mapped to a named cache. This class also enables programmatic configuration of the cache client.</summary>
<summary>Used for programmatically configuring a cache client.</summary>
<paramname="configuration">A <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheFactoryConfiguration"/> object that specifies the cache client configuration settings for the DataCacheFactory instance.</param>
<summary>Returns the cache client, an instance of the <seecref="T:Microsoft.ApplicationServer.Caching.DataCache"/> object.</summary>
<returns>The cache client, an instance of the DataCache object.</returns>
<paramname="cacheName">The named cache to use for cache operations. For , the cache name must be “default”, which is the same as calling <seecref="M:Microsoft.ApplicationServer.Caching.DataCacheFactory.GetDefaultCache"/>.</param>
<summary>Returns the cache client corresponding to the default cache, an instance of the <seecref="T:Microsoft.ApplicationServer.Caching.DataCache"/> object.</summary>
<returns>The cache client, an instance of the DataCache object.</returns>
<summary>Initializes a new instance of the <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheFactoryConfiguration"/> class. This overload specifies a specific name for the cache client.</summary>
<paramname="clientName">The name of the cache client. If the application configuration file specifies multiple named dataCacheClient sections, this parameter can be used to specify which dataCacheClient section to use.</param>
<summary>Create a duplicate DataCacheFactoryConfiguration object.</summary>
<returns>Returns a<seecref="T:System.Object"/> that can be cast to a <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheFactoryConfiguration"/> object.</returns>
<summary>Specifies the parameters required for a method to be invoked by a failure notification when the cache client misses cache notifications. Not supported in Windows Azure Shared Caching.</summary>
<paramname="cacheName">The name of the cache associated with the missing notifications.</param>
<paramname="nd">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object associated with the failure notification that invoked the delegate method.</param>
<summary>Creates a new instance of the <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheLocalCacheProperties"/> class. This overloaded constructor accepts parameters that configure the properties of local cache.</summary>
<paramname="objectCount">The maximum number of objects in the local cache.</param>
<paramname="defaultTimeout">The time that objects reside in the local cache before invalidation.</param>
<paramname="invalidationPolicy">The invalidation policy for the local cache. This can be set to either <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheLocalCacheInvalidationPolicy.NotificationBased"/> or <seecref="F:Microsoft.ApplicationServer.Caching.DataCacheLocalCacheInvalidationPolicy.TimeoutBased"/>.</param>
<summary>Represents a callback method that is to be invoked by a cache notification when one or more cache operations take place. Applies only to the server versions of AppFabric.</summary>
<paramname="regionName">The name of the region associated with the cache operation. A zero-length string indicates that a specific region is not associated with the cache operation.</param>
<paramname="key">The name of the key associated with the cache operation. A zero-length string indicates that a specific cached item is not associated with the cache operation.</param>
<paramname="version">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheItemVersion"/> of the cached object associated with the cache operation that triggered the notification. A null version indicates that a specific cached item is not associated with the cache operation.</param>
<paramname="cacheOperation">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheOperations"/> enumeration specifying which cache event triggered the cache notification.</param>
<paramname="nd">The <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object associated with the cache notification that invoked the delegate method.</param>
<summary>Identifies a cache notification callback. This identifier is required to remove the corresponding cache notification callback. Applies only to the server versions of AppFabric.</summary>
<summary>Identifier for the <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object. Used to distinguish between DataCacheNotificationDescriptor objects.</summary>
<returns>A <seecref="T:System.Int64"/> value used to identify DataCacheNotificationDescriptor objects.</returns>
<summary>Creates a copy of the <seecref="T:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor"/> object.</summary>
<returns>A string value representing the <seecref="P:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor.CacheName"/> and <seecref="P:Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor.DelegateID"/> property values.</returns>
<summary>Returns read-only session-state data from the cache.</summary>
<returns>A SessionStateStoreData object populated with session values and information from the cache</returns>
<paramname="context">The HttpContext of the current request.</param>
<paramname="id">The session identifier for the current request.</param>
<paramname="locked">When this method returns, contains a Boolean value that is set to true if the requested session item is locked in the cache; otherwise, false.</param>
<paramname="lockAge">When this method returns, contains a TimeSpan object that is set to the period of time that an item in the cache has been locked.</param>
<paramname="lockId">When this method returns, contains an object that is set to the lock identifier for the current request.</param>
<paramname="actions">When this method returns, contains one of the SessionStateActions values. This indicates whether the current session is an uninitialized, cookieless session.</param>
<summary>Returns and locks the read-only session-state data from the cache.</summary>
<returns>A SessionStateStoreData object populated with session values and information from the cache.</returns>
<paramname="context">The HttpContext of the current request.</param>
<paramname="id">The session identifier for the current request.</param>
<paramname="locked">When this method returns, contains a Boolean value that is set to true if a lock in the cache is successfully obtained; otherwise, false.</param>
<paramname="lockAge">When this method returns, contains a TimeSpan object that is set to the period of time that an item in the cache has been locked.</param>
<paramname="lockId">When this method returns, contains an object that is set to the lock identifier for the current request.</param>
<paramname="actions">When this method returns, contains one of the SessionStateActions values. This indicates whether the current session is an uninitialized, cookieless session.</param>
