WindowsFormsCacheListener Class |
(14.1.1.0)
E55634-01
Ensures that any event handling code that needs to run
as a response to a cache event is executed on the UI thread.
Inheritance HierarchySystemObject
Tangosol.Net.Cache.SupportDelegatingCacheListener
Tangosol.Net.Cache.SupportWindowsFormsCacheListener
Tangosol.Net.Cache.SupportDelegatingCacheListener
Tangosol.Net.Cache.SupportWindowsFormsCacheListener
Namespace: Tangosol.Net.Cache.Support
Assembly: Coherence (in Coherence.dll) Version: 14.1.1.1 (14.1.1.1)
SyntaxC#
public class WindowsFormsCacheListener : DelegatingCacheListener, ICacheListener
The WindowsFormsCacheListener type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | WindowsFormsCacheListener |
Creates an instance of this class.
|
Methods| Name | Description | |
|---|---|---|
| Equals | (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| OnDeleted |
Raises the EntryDeleted event.
(Inherited from DelegatingCacheListener.) |
| OnInserted |
Raises the EntryInserted event.
(Inherited from DelegatingCacheListener.) |
| OnUpdated |
Raises the EntryUpdated event.
(Inherited from DelegatingCacheListener.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
Events| Name | Description | |
|---|---|---|
 | EntryDeleted |
Occurs when an entry is deleted from the cache.
(Inherited from DelegatingCacheListener.) |
| EntryInserted |
Occurs when a new entry is added to the cache.
(Inherited from DelegatingCacheListener.) |
| EntryUpdated |
Occurs when a cache entry is updated.
(Inherited from DelegatingCacheListener.) |
Remarks
The crucial limiting factor when updating UI elements from a
background thread is the thread affinity Windows Forms controls
and forms have to the underlying thread that created them.
All Windows messages are actually messages between threads,
and each thread has its own message queue. Each and every thread
message can only be processed on the thread it belongs to.
When a thread creates a window, that window's messages are actually
messages destined for the message queue of the creating thread.
Consequently, all windows (such as forms and controls) can only
process messages on the thread that created them. Method calls on
forms and controls often result internally with posting of at least
one such message.
This class allows end users to ignore this fact and handle Coherence
cache events, which are always raised from a background thread, as
if they were raised within the UI thread. This class will ensure that
the call is properly marshalled and executed on the UI thread.
See Also