This document is archived and information here might be outdated.  Recommended version.


IDynamicCacheLayerManager Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Carto)  

IDynamicCacheLayerManager Interface

Provides access to dynamic layers cache management.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

This interface is new at ArcGIS 9.3.

Members

Description
Read/write property AlwaysDrawCoarsestLevel Indicates whether to use the default coarse texture while the requested tile is being processed.
Read-only property Cacheable Indicates whether the layer can have a dynamic cache.
Method Connect Try to connect the given layer to a cache.
Read/write property ConsolidatedGroupLayer Indicates whether the given composite layer cache is consolidated.
Method Delete Delete the cache structure and tiles from the disk.
Read/write property DetailsThreshold The threshold to determine the level of detail to use. Values range from 0 to 100, where 100 means always choose coarse data.
Read-only property FolderName If cache exists, returns the layername plus guid. If cache does not exists, returns nothing.
Read/write property FolderPath The full path of the cache parent directory if the the cache exists.
Read/write property Format The name of the tile format which is used by the cache.
Method Init Initialize the cache manager with the given map and layer.
Method Invalidate Invalidate a certain area of the cache, according to the given extent. If the input extent is null, invalidates the entire cache. Duoble-buffer does not show changes until new tiles are available.
Read/write property MaxCacheScale The maximum scale by which tiles are to be generated.
Read/write property ProgressiveDrawingLevels Number of coarse level data to draw while the current LOD tiles are being processed.
Read/write property ProgressiveFetchingLevels Number of coarse level data to fetch while the current LOD tiles are being processed.
Read/write property StrictOnDemandMode Indicates whether to use a coarse grained drawing in case where there is nothing else to render while waiting for the current map scale data to be cooked.
Method Update Update the cache associated with the layer according to the given extent, between the from-scale to the target-scale and according to the update-mode.

CoClasses that implement IDynamicCacheLayerManager

CoClasses and Classes Description
DynamicCacheLayerManager Dynamic cache layer management utility class.

Remarks

Using this cache management interface, one can pre-generate caches, invalidate regions in existing caches which allow users to update cache as its underlying layer changes without having to rebuild a new cache. Also, it provides for control over the drawing characteristics of the cache.

[C#]

The Interface IDynamicCacheLayerManager was written in order to manage the caches of proprietary dynamic display caches and it should not be used to manage MapServerLayers or rasters. In the case of MapServerLayers and rasters it should only be used to control the drawing characteristics such as StrictOnDemand, ProgressiveFetchingLevels, AlwaysDrawCoarsestLevel etc. Attempting to execute management commands on a MapServerLayers or rasters will return S_FALSE which is interpreted as an exception in .NET.

[Visual Basic .NET]

The Interface IDynamicCacheLayerManager was written in order to manage the caches of proprietary dynamic display caches and it should not be used to manage MapServerLayers or rasters. In the case of MapServerLayers and rasters it should only be used to control the drawing characteristics such as StrictOnDemand, ProgressiveFetchingLevels, AlwaysDrawCoarsestLevel etc. Attempting to execute management commands on a MapServerLayers or rasters will return S_FALSE which is interpreted as an exception in .NET.

.NET Samples

Dynamic cache layer manager controller (Code Files: CacheManagerDlg)

.NET Related Topics

Persisting cache information for use in dynamic display