Add an Object to a Cache

The following examples show the ways you can add objects to the cache.

For more details about the methods that are used in these examples, follow these links to view the class library topics:

• Add

• Put

• Item

To add an object to cache

1. Make sure that the using statement (Imports in Visual Basic) is at the top of your application code to reference the Microsoft.ApplicationServer.Caching namespace.

2. Create a DataCacheFactory object that is accessible to all parts of the application that need a cache client. If possible, store and reuse the same DataCacheFactory object to conserve memory and optimize performance.

3. Use the DataCacheFactory object to create a DataCache object (also referred to as the cache client).

4. After you have the DataCache object, use the Add method, the Put method, or the Item property to add an object to the cache. In the following examples, the DataCache instance is named myCache.

Example

The following example demonstrates how you can use the Add method to add an object to cache. You will get an exception if an object has already been cached by the same key (the first parameter).

'add string object to cache with key "Key0"
myCache.Add("Key0", "object added with Key0")

//add string object to cache with key "Key0"
myCache.Add("Key0", "object added with Key0");

The following example uses the Put method to add an object to cache. If an object has already been cached by the same key, it will be replaced.

'add or replace string object in cache using key "Key0"
myCache.Put("Key0", "object replaced or added using Key0")

//add or replace string object in cache using key "Key0"
myCache.Put("Key0", "object replaced or added using Key0");

The following example uses the Item property that has array notation to add an item to the cache. If an object has already been cached by the same key, it will be replaced.

'add or replace object in cache using array notation
myCache("Key0") = "object replaced or added using Key0"

//add or replace object in cache using array notation
myCache["Key0"] = "object replaced or added using Key0";

See Also

Concepts

Preparing the Cache Client Development Environment (AppFabric 1.1 Caching)
Update an Object in a Cache
Get an Object from a Cache
Remove an Object from a Cache
AppFabric Caching Concepts (AppFabric 1.1 Caching)
Developing a Cache Client

  2012-09-12