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

AzureTileDownloader

Class

Downloads map tile data asynchronously using HTTP requests and supports canceling active requests.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.RadMap.dll

Syntax:

public class AzureTileDownloader : IMapTileDownloader

Inheritance: objectAzureTileDownloader

Implements: IMapTileDownloader

Constructors

AzureTileDownloader()

Initializes a new instance of the AzureTileDownloader class.

public AzureTileDownloader()

Fields

webClientsPool

Dictionary<string, HttpClient>

Tracks active HTTP clients by the quadkey of their tile.

protected Dictionary<string, HttpClient> 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 tile request.

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 downloading a map tile from the specified URI for the given tile information.

public virtual void BeginDownloadTile(Uri uri, TileInfo tileInfo)

Parameters:uriUri

The URI of the tile to download.

tileInfoTileInfo

The tile information associated with the download.

Implements: IMapTileDownloader.BeginDownloadTile(Uri, TileInfo)

CancelTileDownload(TileInfo)

Cancels an ongoing tile download for the specified tile.

public void CancelTileDownload(TileInfo tileInfo)

Parameters:tileInfoTileInfo

The tile information to cancel the download for.

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.

Events

TileDownloadComplete

TileInfoEventHandler

Occurs when a tile download is complete.

public event TileInfoEventHandler TileDownloadComplete

Implements: IMapTileDownloader.TileDownloadComplete