SetCacheOptions Method

In This Topic

Sets the layer's caching options. If the layer's feature class supports feature caching, then both the display cache and feature cache are set otherwise just the display cache is set. This method must be called on the MCT. Use QueuedTask.Run

Syntax

Visual Basic (Declaration)
C#

Public Sub SetCacheOptions( _
   ByVal cacheType As LayerCacheType _
)

public void SetCacheOptions( 
   LayerCacheType cacheType
)

Parameters

cacheType: The cache type.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Remarks

The caching options are as follows

None - Don't cache the layer locally. If the layer supports feature caching (i.e. is a feature service layer), then any existing cache is also cleared.
Session - Cache will be cleared when the session ends.
MaxAge - Cache will be kept between sessions and cleared every MaxDisplayCacheAge minutes. If the layer supports feature caching (i.e. is a feature service layer), then this caching option is not supported and no changes are made.
Permanent - Cache will be kept between sessions and invalidated when the data is updated. If the layer supports feature caching (i.e. is a feature service layer), then this caching option is not supported and no changes are made.

Refer to the Pro help for more information on caching: How caching works.
Note: for feature services only ArcGIS.Core.CIM.DisplayCacheType.InSession and ArcGIS.Core.CIM.DisplayCacheType.None are supported. For branch versioned feature services, caching is managed by the application automatically and is set to DisplayCacheType.InSession.
Attempting to set a cache type on a layer that is not supported is ignored. Note: If setting LayerCacheType.MaxAge, call SetDisplayCacheMaxAge to set the duration otherwise it uses the default value that is 5.0 minutes.

Example

Set the layer cache

{
    // change from the default 5 min to 2 min
    //Note: needs to be called on the MCT
    featureLayer.SetDisplayCacheMaxAge(TimeSpan.FromMinutes(2));
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

Layer Class
Layer Members

Send feedback