Telerik.Web.UI.RadChart

The class represents the base functionality of the RadChart.

Inheritance Hierarchy

• System.Object
• System.Web.UI.Control
• System.Web.UI.WebControls.WebControl
• System.Web.UI.WebControls.BaseDataBoundControl
• System.Web.UI.WebControls.DataBoundControl
• Telerik.Web.UI.RadDataBoundControl : IControl, IControlResolver, IFeatureGroup, IPostBackDataHandler, IScriptControl, ISkinnableControl
• Telerik.Web.UI.RadChart : ICallbackEventHandler, IChartComponent, INamingContainer, IPostBackEventHandler, IStateManager

Properties

AlternateText String

The alternate text displayed when the image cannot be shown.

Appearance StyleChart

Chart style

AutoLayout Boolean

Specifies AutoLayout mode to all items on the chart control.

AutoTextWrap Boolean

Specifies AutoLayout mode to all items on the chart control.

Chart Chart

Chart engine

ChartImageFormat Chart

Specifies the image format in which the image is streamed.

ChartTitle Chart

The chart title message.

ClientDataSourceID String

Gets or sets ID of ClientDataSource control that is used for client side binding

ClientIDMode ClientIDMode

This property is overridden in order to support controls which implement INamingContainer. The default value is changed to "AutoID".

ClientSettings ChartClientSettings

Client-side settings.

ContentFile String

Gets or sets RadChart's content file path and file name.

CreateImageMap Boolean

Enables or disables use of image maps.

CssClassFormatString String

The CssClass property will now be used instead of the former Skin and will be modified in AddAttributesToRender()

CustomFigures CustomFiguresCollection

Specifies the custom palettes for chart

CustomPalettes CustomPalettesCollection

Specifies the custom palettes for chart

DataGroupColumn String

Gets or sets the name of the DataSource column (member) that will be used to split one column data into several chart Series

DataManager DataManager

Data management support object

DataMember String

Gets or sets the name of the list of data that the data-bound control binds to, in cases where the data source contains more than one distinct list of data items.

DataSource Object

The DataSource object

Remarks

Gets or sets the object from which the chart control retrieves its list of data items

DataSourceID String

Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

DefaultType ChartSeriesType

Default chart series type

EnableAjaxSkinRendering String

Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests

Remarks

If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax.

EnableEmbeddedBaseStylesheet Boolean

Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.

Remarks

If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand.

EnableEmbeddedScripts Boolean

Gets or sets the value, indicating whether to render script references to the embedded scripts or not.

Remarks

If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand.

EnableEmbeddedSkins String

Gets or sets the value, indicating whether to render links to the embedded skins or not.

Remarks

If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand.

EnableHandlerDetection Boolean

Gets or sets a value indicating whether RadChart should automatically check for the ChartHttpHandler existence in the system.web section of the application configuration file.

Remarks

Set this property to false if you are running your application under IIS7 Integrated Mode and have set the validateIntegratedModeConfiguration flag that does not allow legacy HttpHandler registration under the system.web configuration section.

EnableRippleEffect Boolean

Returns true if ripple effect should be added

Height Unit

Chart height

HttpHandlerUrl String

Gets or sets a value indicating the URL to the ChartHttpHandler that is necessary for the correct operation of the RadChart control.

Remarks

Generally the default relative value should work as expected and you do not need to modify it manually here; however in some scenarios where url rewriting is involved, the default value might not work out-of-the-box and you can customize it via this property to suit the requirements of your application.

IntelligentLabelsEnabled Boolean

Enables / disables Intelligent labels logic for series items labels in all plot areas.

IsSkinSet String

For internal use.

Legend ChartLegend

Gets or sets RadChart's legend object.

ODataDataSourceID String

Gets or sets the ODataDataSource used for data binding.

PlotArea ChartPlotArea

Specifies the chart's plot area.

RegisterWithScriptManager Boolean

Gets or sets the value, indicating whether to register with the ScriptManager control on the page.

Remarks

If RegisterWithScriptManager is set to false the control can be rendered on the page using Web Services or normal callback requests/page methods.

RenderMode RenderMode

Specifies the rendering mode of the control. Setting the mode to Lightweight will yield HTML 5/CSS 3 html and css. If the set value is Auto use ResolvedRenderMode to receive the actual RenderMode with respect to the user angent of the current request.

Remarks

Lightweight rendering mode might change the outlook of the component in some older browsers that don't support CSS3/HTML5.

ResolvedRenderMode RenderMode

Returns resolved RenderMode should the original value was Auto

RuntimeSkin String

Gets the real skin name for the control user interface. If Skin is not set, returns "Default", otherwise returns Skin.

ScaleEnabled Boolean

This property supports the RadChart infrastructure and is not intended for public use.

Series ChartSeriesCollection

Collection of the chart's data series.

SeriesOrientation ChartSeriesCollection

Specifies the orientation of chart series on the plot area.

SeriesPalette String

Specifies the series palette

Skin String

Gets or sets the skin name for the control user interface.

Remarks

If this property is not set, the control will render using the skin named "Default". If EnableEmbeddedSkins is set to false, the control will not render skin.

SkinsOverrideStyles String

Should skin override user setting or not

TempImagesFolder String

Sets folder for the chart's temp images.

UseSession Boolean

Enables or disables use of session.

Width Unit

Chart width

Methods

AddChartSeries

Adds a new data series to the RadChart's series collection.

Parameters

chartSeries Telerik.Charting.ChartSeries

Returns

System.Void

ApplyConditionalRendering

Use this from RenderContents of the inheritor

Returns

System.Void

Clear

Removes the data series associated with the chart control.

Returns

System.Void

ClearSkin

Resets current chart's skin to default

Returns

System.Void

ControlPreRender

Code moved into this method from OnPreRender to make sure it executed when the framework skips OnPreRender() for some reason

Returns

System.Void

CreateSeries

Creates a new chart series and adds it to the series collection.

Parameters

seriesName System.String

mainColor System.Drawing.Color

secondColor System.Drawing.Color

chartSeriesType Telerik.Charting.ChartSeriesType

Returns

Telerik.Charting.ChartSeries

DataBind

Binds a data source to the invoked server control and all its child controls.

Returns

System.Void

DescribeRenderingMode

Should be used by inheritors

Returns

System.Void

GetEmbeddedSkinNames

Returns the names of all embedded skins. Used by Telerik.Web.Examples.

Returns

System.Collections.Generic.List1`

GetSeries

Gets a reference to the data series object at the specified index.

Parameters

seriesIndex System.Int32

Returns

Telerik.Charting.ChartSeries

GetSeries

Gets a reference to the data series object with the specified name.

Parameters

seriesName System.String

Returns

Telerik.Charting.ChartSeries

GetSeries

Gets a reference to the data series object with the specified color.

Parameters

seriesColor System.Drawing.Color

Returns

Telerik.Charting.ChartSeries

LoadClientState

Loads the client state data

Parameters

clientState System.Collections.Generic.Dictionary{System.String,System.Object}

Returns

System.Void

LoadFromXml

Loads RadChart's settings and data from external XML file.

Parameters

relativeFileName System.String

Returns

System.Void

LoadFromXml

Loads entire chart settings from a TextWriter object

Parameters

reader System.IO.TextReader

Returns

System.Void

LoadPostData

Executed when post data is loaded from the request

Parameters

postDataKey System.String

postCollection System.Collections.Specialized.NameValueCollection

Returns

System.Boolean

LoadSkin

Loads user skin from a TextWriter object

Parameters

text System.IO.TextWriter

Returns

System.Void

RaisePostDataChangedEvent

Executed when post data changes should invoke a changed event

Returns

System.Void

RegisterCssReferences

Registers the CSS references

Returns

System.Void

RegisterScriptControl

Registers the control with the ScriptManager

Returns

System.Void

RemoveAllSeries

Removes all data series from the series collection without removing axis items.

Returns

System.Void

RemoveSeriesAt

Removes the data series at the specified index.

Parameters

seriesIndex System.Int32

Returns

System.Void

Save

Saves the chart with the specified file name.

Parameters

filename System.String

Returns

System.Void

Save

Saves the chart with the specified file name and the specified image format.

Parameters

filename System.String

imageFormat System.Drawing.Imaging.ImageFormat

Returns

System.Void

SaveClientState

Saves the client state data

Returns

System.String

SaveSkin

Exports current chart's skin into TextWriter object

Returns

System.IO.TextWriter

SaveToXml

Exports current chart's settings into TextWriter object

Returns

System.IO.TextWriter

SaveToXml

Saves the chart's state into XML file in the specified by fileName location.

Parameters

fileName System.String

Path to the file

Returns

System.IO.TextWriter

SetDataSourceID

Changes the DataSourceID property without DataBind method call

Parameters

id System.String

Returns

System.Void