Layer.FlushCache Method
Marks the layer as flushed which will release cached resources during the next update.
FlushCache()
Marks the layer as flushed which will release cached resources during the next update.Syntax
public void FlushCache ()Remarks
Calling FlushCache does not flush cached resources immediately, it only marks the layer as having been flushed and defers the actual operation until the next update.
This operation is not recursive, i.e. it does not propagate to operators or other layers. This method should be called when, for instance, a visualization has been changed in a Layer that is buffered.
Flushing layers correctly
The technique of flushing a TileLayer or BitmapLayer correctly is essential to learn to get the best performance in an application.
A TileLayer buffers the presentation generated by all its child layers and if the visualization is changed in a single specific OrdinaryLayer then only that specific layer needs to be flushed (note that the TileLayer will only detect flush operations on child layers of type OrdinaryLayer). This will result in the best performance since cached objects generated by other layers remain untouched and can be reused. If you instead call FlushCache on a TileLayer then everything that has been cached will be released during the next update.
A BitmapLayer works in a similar fashion except that you must flush the layer itself and not individual child layers. See the documentation for BitmapLayer for more information.
Example
// FlushCache at the Layer
public static void FlushCacheAtLayer(Layer layer)
{
// Call FlushCache at the Layer
// Calling FlushCache does not may not flush cached resources immediately,
// in some cases it only marks the layer as having been flushed and defers
// the actual operation until the next update.
layer.FlushCache();
}
Platforms
Windows, Linux, Android