Manage feature cache

You can access controls to manage the feature cache on the Map tab in the Feature Cache group. Use these controls to fill the cache, empty the cache, cancel a current cache fill, or set the cache to automatically fill. These controls are applied independently to each map in a project.

For more information on caching, see Set caching options.

Initially, the Feature Cache group is not enabled within ArcGIS AllSource and the application will automatically cache features. See the following section to access this group of controls.

Show the Feature Cache group

By default, the Feature Cache group is hidden on the ribbon. Follow these steps to access the controls in this group.

  1. Click the Project tab and click Options.
  2. On the Options dialog box, under the Application heading, click the Map and Scene tab.
  3. Expand Feature Cache and check Manage feature cache from the Map tab.
  4. Click OK to save your settings and close the dialog box.

Auto Cache

When the Feature Cache group has been enabled, the Auto Cache check box within the Feature Cache group on the Map tab is turned on for each new map and the feature cache will fill based on the feature cache criteria. Turn this option off to manage the cache manually. The Auto Cache setting can be changed independently for each map in a project to manage this setting as your workflow requires. As noted below, if layers share the same data source across multiple maps, Fill Enable Feature Cache and Empty Clear Feature Cache may affect Auto Cache.

Note:

While a fill that has been initiated from Fill Enable Feature Cache is in progress, automatic caching is paused for the entire project until the current fill is complete.

Caution:

It is possible to turn off Auto Cache for a map and then turn off the Feature Cache group.

In this scenario, maps that had Auto Cache turned off will continue not caching features. New maps and maps that had Auto Cache on will continue with Auto Cache behavior and will cache features.

Fill the feature cache for the current map

The feature cache must be filled before it can be used.

On the Map tab in the Feature Cache group, click Fill Enable Feature Cache to fill the cache for all layers that are visible in the map.

Caution:

If you don't see the Feature Cache group on the Map tab, follow the steps in a previous section to access these controls.

The cache fills based on the current extent of the map. Unlike Auto Cache, which uses criteria to determine which layers are filled, Fill Enable Feature Cache caches all layers that are visible in the Contents pane. Only one fill process can occur per project at a time. While the cache is filling, the Fill button Enable Feature Cache is unavailable for all maps in the project until the fill is complete or is cancelled. While the cache is filling, you can pan and zoom around the map or view other maps without affecting the fill progress. Filling the feature cache at multiple extents is supported. Automatic caching is paused for the entire project until the fill has been completed.

If a layer's data source is shared across multiple maps in the same project, the cached features are shared across the maps.

A notification alerts you when the cache begins to fill, when the fill is complete, or if an error occurs.

Note:

  • Building a cache for a large area or for an area with many features may take some time. To cancel filling the cache, click Cancel Disable Feature Cache.
  • If there are no visible web feature layers in the map, or if the layers are set to not cache within the layer's properties, a fill is not supported and you will receive a notification.
  • Certain scenarios may suspend the feature cache and prevent its use. Save or discard edits to reset the feature cache so it can again be filled.

Caution:

When using Fill Enable Feature Cache in conjunction with Auto Cache, the Fill button Enable Feature Cache will cancel any automated fills in progress. In this workflow, it is recommended that you wait 15 seconds after the map has finished drawing to allow the automated fill procedure to complete before using Fill Enable Feature Cache.

Empty the feature cache for the current map

Emptying the feature cache can be done periodically if there are edits made to the underlying layer from other sources.

On the Map tab in the Feature Cache group, click Empty Clear Feature Cache to empty the feature cache for all layers in the current map.

Caution:

If you don't see the Feature Cache group on the Map tab, follow the steps in a previous section in this topic to access these controls.

The Empty button Clear Feature Cache is always enabled and does not become inactive. The empty operation does not occur if there are pending edits. Edits must be saved or discarded before emptying the feature cache.

If a layer's data source is shared across multiple maps in the same project, the cache for these layers in other maps is affected during the empty operation.

A notification alerts you when the cache is emptied, when an error occurs, or if there are pending edits.

Cancel filling the feature cache

If you have clicked the Fill button Enable Feature Cache and the fill is taking longer than expected, or if you clicked it by accident, you can cancel the process. This button is available only when a cache is being filled.

On the Map tab in the Feature Cache group, click Cancel Disable Feature Cache to cancel fill requests in progress.

Caution:

If you don't see the Feature Cache group on the Map tab, follow the steps in a previous section in this topic to access these controls.

A notification alerts you when a cache fill has been cancelled.