Class AsyncReaderBase

Base class for the asynchronous map shape readers (KML, ESRI, WKT/WKB).

Inheritance
System.Object
DisposableObject
RadObject
AsyncReaderBase
AsyncFileReaderBase
AsyncSqlGeospatialDataReader
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.RadMap.dll

Syntax

public abstract class AsyncReaderBase : RadObject, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor

Constructors

AsyncReaderBase()

Declaration
protected AsyncReaderBase()

Fields

ClearLayerProperty

Declaration
public static readonly RadProperty ClearLayerProperty
Field Value
RadProperty

CoordinateConverterProperty

Declaration
public static readonly RadProperty CoordinateConverterProperty
Field Value
RadProperty

ExtendedPropertySetProperty

Declaration
public static readonly RadProperty ExtendedPropertySetProperty
Field Value
RadProperty

ToolTipFormatProperty

Declaration
public static readonly RadProperty ToolTipFormatProperty
Field Value
RadProperty

Properties

ClearLayer

Gets or sets the ClearLayer property. If it is set to true, then the reader clears its information layer after reading.

Declaration
public bool ClearLayer { get; set; }
Property Value
System.Boolean

CoordinateConverter

Gets or sets the CoordinateConverter applied to the reader.

Declaration
public ICoordinateConverter CoordinateConverter { get; set; }
Property Value
ICoordinateConverter

ExtendedPropertySet

Gets or sets extended property set which will be used during shape file (KML or ESRI) reading.

Declaration
public ExtendedPropertySet ExtendedPropertySet { get; set; }
Property Value
ExtendedPropertySet

Remarks

Can be null. In this case extended property set will be created depends on the extended data available in the KML file or in the attributes file (DBF).

Layer

Target layer.

Declaration
public MapLayer Layer { get; set; }
Property Value
MapLayer

ToolTipFormat

Gets or sets tooltip format. Either ToolTipFormat or ToolTipTemplate should be specified. If both properties are set, then ToolTipTemplate will be used.

Declaration
public string ToolTipFormat { get; set; }
Property Value
System.String

Examples

The tooltip format can be specified in a few different ways: as simple name of the extended property, as formatted extended property, or as format string which can use number of the extended properties.

this.visualizationLayer.Reader = new AsyncShapeFileReader();

// Using of the single extended property name.
this.visualizationLayer.Reader.ToolTipFormat = "CNTRY_NAME";

// Using of the formatted extended property.
// The '|' character is used to separate extended property name and its output format.
this.visualizationLayer.Reader.ToolTipFormat = "SUM_SQMI_A|F2";

// Format string with number of the extended properties.
this.visualizationLayer.Reader.ToolTipFormat = "{CNTRY_NAME} Miles: {SUM_SQMI_A|F2}, KM: {SUM_SQKM_A|F1}";
Me.visualizationLayer.Reader = New AsyncShapeFileReader()

' Using of the single extended property name.
Me.visualizationLayer.Reader.ToolTipFormat = "CNTRY_NAME"

' Using of the formatted extended property.
' The '|' character is used to separate extended property name and its output format.
Me.visualizationLayer.Reader.ToolTipFormat = "SUM_SQMI_A|F2"

 Format string with number of the extended properties.
Me.visualizationLayer.Reader.ToolTipFormat = "{CNTRY_NAME} Miles: {SUM_SQMI_A|F2}, KM: {SUM_SQKM_A|F1}"
<telerik:AsyncShapeFileReader Source="/Telerik.RadMap.Silverlight;component/africa"
    ToolTipFormat="CNTRY_NAME">

<telerik:AsyncShapeFileReader Source="/Telerik.RadMap.Silverlight;component/africa"
    ToolTipFormat="SUM_SQMI_A|F2">

<telerik:AsyncShapeFileReader Source="/Telerik.RadMap.Silverlight;component/africa"
    ToolTipFormat="{}{CNTRY_NAME} Miles: {SUM_SQMI_A|F2}, KM: {SUM_SQKM_A|F1}">
.

Methods

CancelAsync()

Cancels loading of shapes.

Declaration
public void CancelAsync()

CancelAsync(Int32)

Cancels loading of shapes by process id.

Declaration
public void CancelAsync(int processId)
Parameters
System.Int32 processId

Id of the process.

OnReaderPropertyChanged(RadPropertyChangedEventArgs)

Occurs when the properties which are used for loading are changed.

Declaration
protected virtual void OnReaderPropertyChanged(RadPropertyChangedEventArgs eventArgs)
Parameters
RadPropertyChangedEventArgs eventArgs

Event arguments.

ReadAsync()

Reads geospatial data using asynchronous mode.

Declaration
public abstract int ReadAsync()
Returns
System.Int32

ReadAsync(Object)

Reads geospatial data using asynchronous mode.

Declaration
public abstract int ReadAsync(object userState)
Parameters
System.Object userState

A user-defined object that is passed to the method invoked when the asynchronous operation completes.
Returns
System.Int32

ReaderPropertyChanged(RadObject, RadPropertyChangedEventArgs)

Starts loading when the properties which are used for loading are changed.

Declaration
protected static void ReaderPropertyChanged(RadObject source, RadPropertyChangedEventArgs eventArgs)
Parameters
RadObject source

Source object.
RadPropertyChangedEventArgs eventArgs

Event arguments.

Events

PreviewReadShapeData

Occurs when a shape data is read.

Declaration
public event PreviewReadShapeDataCompletedEventHandler PreviewReadShapeData
Event Type
PreviewReadShapeDataCompletedEventHandler

PreviewReadShapeDataCompleted

Occurs when the reader completes to read shapes.

Declaration
public event PreviewReadShapeDataCompletedEventHandler PreviewReadShapeDataCompleted
Event Type
PreviewReadShapeDataCompletedEventHandler

ProgressChanged

Occurs when part of data is read.

Declaration
public event ProgressChangedEventHandler ProgressChanged
Event Type
System.ComponentModel.ProgressChangedEventHandler

ReadShapeDataCompleted

Occurs when the reader completes to read shapes and pass them to target information layer.

Declaration
public event ReadShapeDataCompletedEventHandler ReadShapeDataCompleted
Event Type
ReadShapeDataCompletedEventHandler

Extension Methods