Adding an Entry to the Cache

Populate a client region with cache entries by using the generic IDictionary API or by using the .NET Region.Put or the Region.Create API functions.

The Put function places a new value into a region entry with the specified key, while the Create function creates a new entry in the region. The Put and Create functions provide a user-defined parameter object to any cache writer invoked in the process.

If a value for the entry key already exists in the cache when you add an entry, GemFire overwrites the previously cached value. New values in the cache are propagated to the connected cache server.

The .NET Generics provide type safety, so you cannot change your entry key and value types once you have begun to populate the region. If you need to use different types for the same region, store them all inside objects in the region.

Using the API to Put Values Into the Cache

In this example, the program puts entries into the cache with string values.

region1["Key1"] = "Value1";
region1["Key2"] = "Value2";

region2["KeyA"] = 123;
region2["KeyB"] = 100;
region3.Put(111, "Value1", null);
region3.Put(222, "Value2", null);

Batch Operations—Using PutAll to Add Multiple Entries

You can batch up multiple key/value pairs into a hashmap and put them into the cache with a single operation using the .NET Region.PutAll API function. Each entry is processed for interest registration on the server, so each entry requires its own unique event ID. Updates and creates can be mixed in a PutAll operation, so those events need to be addressed on the cache server for appropriate cache listener invocation on distributed system members. Map entries retain their original order when they are processed at the server.