CacheOptions.DiskLimit Property

Specifies the disk space (in megabytes) to store tile images obtained from a map data provider.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v20.1.dll

Declaration

[DefaultValue(-1)]
public int DiskLimit { get; set; }
<DefaultValue(-1)>
Public Property DiskLimit As Integer

Property Value

Type Default Description
Int32

-1

An integer value that is the disk limit for storing tile images, in megabytes.

Property Paths

You can access this nested property as listed below:

Object Type Path to DiskLimit
BingMapDataProvider
.CacheOptions.DiskLimit
ImageTileDataProvider
.CacheOptions.DiskLimit
MapboxDataProvider
.CacheOptions.DiskLimit
MapDataProviderBase
.CacheOptions.DiskLimit
MapTileDataProviderBase
.CacheOptions.DiskLimit
MbTilesDataProvider
.CacheOptions.DiskLimit
OpenStreetMapDataProvider
.CacheOptions.DiskLimit
UriBasedVectorTileDataProvider
.CacheOptions.DiskLimit
VectorTileDataProviderBase
.CacheOptions.DiskLimit

Examples

This example illustrates what is required to customize the local cache of a map control.

The local cache allows you to save internet resources and significantly increase map performance by loading saved map tiles from the local directory.

To enable map cache, specify the directory to which the loaded map tiles will be saved using the CacheOptions.DiskFolder property and the time interval after which the loaded map tiles should be updated using the CacheOptions.DiskExpireTime property. To access the CacheOptions object, use the MapTileDataProviderBase.CacheOptions property.

In addition, you can specify the amount of memory on the computer and disk space (in megabytes) for storing tile images via CacheOptions.MemoryLimit and CacheOptions.DiskLimit properties, respectively.

In this example tile images of a map are loaded from the OpenStreetMap resource.

using System;
using System.Windows.Forms;
using DevExpress.XtraMap;

namespace CacheImageTiles {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            // Create a map control.
            MapControl map = new MapControl();

            // Specify the map position on the form.           
            map.Dock = DockStyle.Fill;

            // Add the map control to the window.
            this.Controls.Add(map);

            // Create an image tiles layer and add it to the map.
            ImageLayer tilesLayer = new ImageLayer();
            map.Layers.Add(tilesLayer);

            // Create an Open Street data provider.
            OpenStreetMapDataProvider provider = new OpenStreetMapDataProvider();
            tilesLayer.DataProvider = provider;

            // Customize a local cache for storing image tiles obtained from the Open Street provider.
            provider.CacheOptions.DiskFolder = "C://MapTiles"; 
            provider.CacheOptions.DiskExpireTime = new TimeSpan(01,00,00);
            provider.CacheOptions.MemoryLimit = 64;           
            provider.CacheOptions.DiskLimit = 200;
        }
    }
}
See Also