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.
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
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);
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.