New to Telerik UI for WinForms? Start a free 30-day trial

MapTileDownloader

Class

Downloads map tile data asynchronously and exposes request headers for customization.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.RadMap.dll

Syntax:

public class MapTileDownloader : IMapTileDownloader

Inheritance: objectMapTileDownloader

Implements: IMapTileDownloader

Constructors

MapTileDownloader()

Initializes a new instance of the MapTileDownloader class.

public MapTileDownloader()

Fields

webClientsPool

Dictionary<string, WebClient>

Tracks active web requests by the quadkey of their tile.

protected Dictionary<string, WebClient> webClientsPool

webClientsPoolLockObject

object

Synchronizes access to the active request and URI dictionaries.

protected object webClientsPoolLockObject

webRequestCache

Dictionary<string, Uri>

Stores the URI associated with each active request, keyed by tile quadkey.

protected Dictionary<string, Uri> webRequestCache

Properties

WebHeaders

WebHeaderCollection

Gets a collection of WebHeaders that will be sent to the server with each tile download request.

public WebHeaderCollection WebHeaders { get; }

Methods

BeginDownloadTile(Uri, TileInfo)

Begins a new tile download.

public virtual void BeginDownloadTile(Uri uri, TileInfo tileInfo)

Parameters:uriUri

The URI.

tileInfoTileInfo

The tile information.

Implements: IMapTileDownloader.BeginDownloadTile(Uri, TileInfo)

CancelTileDownload(TileInfo)

Cancels a ongoing tile download.

public virtual void CancelTileDownload(TileInfo tileInfo)

Parameters:tileInfoTileInfo

The tile information.

Implements: IMapTileDownloader.CancelTileDownload(TileInfo)

OnTileDownloadComplete(TileInfoEventArgs)

Fires the event.

protected virtual void OnTileDownloadComplete(TileInfoEventArgs e)

Parameters:eTileInfoEventArgs

The TileInfoEventArgs instance containing the event data.

ShouldRetryDownload(Exception)

Determines whether a failed download should be performed again.

protected virtual bool ShouldRetryDownload(Exception error)

Parameters:errorException

The error.

Returns:

bool

true if XXXX, false otherwise.

TileDownloadDataCompleted(object, DownloadDataCompletedEventArgs)

Called when the data download for the tile is complete.

protected virtual void TileDownloadDataCompleted(object sender, DownloadDataCompletedEventArgs e)

Parameters:senderobject

The sender.

eDownloadDataCompletedEventArgs

The DownloadDataCompletedEventArgs instance containing the event data.

Events

TileDownloadComplete

TileInfoEventHandler

Occurs when a tile download is complete.

public event TileInfoEventHandler TileDownloadComplete

Implements: IMapTileDownloader.TileDownloadComplete