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


IDynamicCacheLayerManager.ConsolidatedGroupLayer Property (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Carto)  

IDynamicCacheLayerManager.ConsolidatedGroupLayer Property

Indicates whether the given composite layer cache is consolidated.

[Visual Basic .NET]
Public Property ConsolidatedGroupLayer As Boolean
[C#]
public bool ConsolidatedGroupLayer {get; set;}
[C++]
HRESULT get_ConsolidatedGroupLayer(
  VARIANT_BOOL* consolidated
);
[C++]
HRESULT put_ConsolidatedGroupLayer(
  VARIANT_BOOL consolidated
);
[C++]

Parameters consolidated [out, retval] consolidated is a parameter of type VARIANT_BOOL consolidated [in] consolidated is a parameter of type VARIANT_BOOL

Product Availability

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

Remarks

By default, group layers are considered a single layer when dynamic display creates it's cache for the layer.  This means that any changes to the visibility of sub layers will not be honored until the cache is recreated.  This is done to reduce the number of caches that dynamic display must create for your static vector layers in your map.  

By setting this to false dynamic display creates a separate cache for each individual layer sublayer. At runtime, each cache is translated into textures when it comes to displaying the cache in dynamic mode. This means that when displayed, each layer is rendered as a sequence of adjacent textures in the form of seamless tiles. Each of these textures eventually takes a certain amount of memory on the graphics card.  This will have a negative affect on performance, but it will give the developer more control to update the cache for individual layers.

If a map service layer is a sublayer in a group layer then this property will always be set to 'false'.

See Also

IDynamicCacheLayerManager Interface