New major version of RadCalendar is now available as a part of RadControls “Prometheus” for ASP.NET. Its new architecture is based on top the ASP.NET AJAX framework in order to directly benefit from client-side behaviors and capabilities. We strongly recommend using the new version for all new development.
Telerik RadCalendar v2.2.3 (part of Telerik RadControls for ASP.NET Q3 2007 SP1)
Improved RadDate/TimePicker controls rendering: if no buttons are enabled (RadDatePicker1.DatePopupButton.Visible = "false"), the picker renders in a span element.
Telerik RadCalendar v2.2.0 (part of Telerik RadControls for ASP.NET Q2 2007)
New rendering for the RadDate/TimePicker has been implemented, which introduces the following changes:
- The width should be applied to the DatePicker control, not to its RadDateInput part. Setting width to the DateInput will no longer be applicable.
- A few skins have been modified: Mac, Inox and Macromedia -> they now come with fixed width skins
Telerik RadCalendar v2.1.0 (part of Telerik RadControls for ASP.NET Q1 2007)
RadCalendar breaking changes
The logic controlling the range dates for RadCalendar has been revised and now both the RangeMinDate and the RangeMaxDate property values are valid for selection.
RadDatePicker breaking changes
The logic controlling the blank date display is separated from the MinDate value, i. e. setting the SelectedDate property to the MinDate value will not clear the RadDatePicker control anymore. You can display a blank date by not setting the SelectedDate or by calling the RadDatePicker.Clear() method. You can clear the date by setting the SelectedDate property to null as well (the SelectedDate property is implemented as a nullable DateTime object in ASP.NET 2.0).If the date picker has an empty value, its SelectedDate property returns DateTime.MinValue value. You can check if the date picker is empty by the IsEmpty property.
Due to the fact that the blank date display logic is separated from the MinDate value now, there are certain implications related to validating the picker controls against a RequiredFieldValidator -- you no longer need to set the InitialValue attribute of the validator (and in fact if you do the validation will not work correctly).you should set the InitialValue attribute of the validator to the DateTime.MinValue value instead of the MinDate value of the respective picker control (the latter works only for calendar versions prior to v2.1.x). You can find more details on validation here.
Note that the new version of RadDatePicker uses the new major version of RadDateInput (part of RadInput v2.0). You can find the changes and backwards compatibility guide for the RadInput here.
RadDatePicker Changes
|
Description |
Type |
Change |
|
Clear() - Clears the selected date of the RadDatePicker control and displays a blank date. |
method |
New |
Telerik RadCalendar v2.0 (part of Telerik RadControls for ASP.NET Q4 2006)
Breaking changes
OperationType - removed
As of version 2.0 the OperationType property is removed. Telerik RadCalendar works entirely on client-side unless the AutoPostBack property is set to true. Then Telerik RadCalendar will start making requests to the server (as in the old server mode).
Telerik RadCalendar has no longer its own AJAX mechanism. If you want Telerik RadCalendar to work with AJAX requests, you should wrap it in AjaxPanel or set it with AjaxManager (both part of the Telerik RadAjax suite).
You should remove all declarations and settings of the OperationType from your code.
VisualSettings - removed
The VisualSettings collection is removed. Telerik RadCalendar will use Appearance Styles for customizing its visual appearance beyond the settings defined by the used skin.
You should remove all declarations and settings of the VisualSettings from your code.
Other changes
Skins: As of version 2.0 you can have two or more calendars on the same page each with different skin.
|
Description |
Type |
Change |
|
GridLine property is removed as now you can have the same effect using the Appearance styles. |
property |
Removed |
|
EnablePreview property is now removed and Telerik RadCalendar no longer supports Preview mode. |
property |
Removed |
|
EnableColumnSelectors is now replaced with ShowColumnHeaders |
property |
Replaced |
|
EnableRowSelectors is now replaced with ShowRowHeaders |
property |
Replaced |
|
UseDaysAsSelectors is now replaced with UseColumnHeadersAsSelectors. There is a slight change in the behavior of this property. You can disable column selection by setting this property to false. |
property |
Replaced |
|
UseWeekNumbersAsSelectors is now replaced with UseRowHeadersAsSelectors. There is a slight change in the behavior of this property. You can disable row selection by setting this property to false. |
property |
Replaced |
|
RowSelectorText is now replaced with RowHeaderText |
property |
Replaced |
|
RowSelectorImage is now replaced with RowHeaderImage |
property |
Replaced |
|
ColumnSelectorText is now replaced with RowHeaderText |
property |
Replaced |
|
ColumnSelectorImage is now replaced with ColumnHeaderImage |
property |
Replaced |
|
AutoPostBackOnDayClick |
property |
Removed |
|
AutoPostBackOnNavigation |
property |
Removed |
|
RadCalendar.AutoPostBack- gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control |
property |
New |
|
RadDatePicker.AutoPostBack - gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control |
property |
New |
|
RadDatePicker.ClientEvents.TypingTimeOut - gets or sets the timeout in milliseconds that should expire after the last keystroke in the date input component in order to fire the OnDateSelected client-side event |
property |
New |
|
SelectorCellRender is now replaced with HeaderCellRender |
event |
Replaced |
Telerik RadCalendar v1.8.3 (part of Telerik RadControls for ASP.NET Q3 2006 SP3)
We applied some modifications to the client-side events of Telerik RadCalendar and Telerik RadDatePicker in the Q3 2006 SP3 release.
Previously referring to this in the client-side event handler referred to the Telerik RadCalendar / Telerik RadDatePicker instance. Starting from Telerik RadCalendar v1.8.3 this is no longer the case - instead all client-side event handlers now receive two arguments - the first one is the control instance (previously referred as this) and the second one is either a composite argument (containing all of the old parameters supplied to the client-side event handler) or a simple argument (if the respective event handler received single parameter).
See Telerik RadCalendar Client-Side/Client-Side Events section for more details.
Telerik RadCalendar v1.7
As of Q2 2006 we have introduced a variety of new common skins (themes in ASP.NET 2.0) for all Telerik RadControls for ASP.NET. By default all controls take a new polished look and feel which is consistent across the whole product line. Five other new common skins (Outlook, Mac, Inox, Telerik and WebBlue) have been added to all Telerik RadControls for ASP.NET for a richer set of interface designs to choose from.
 |
Please, note that if you want to use the old default skins of any product you can still find them in RadControls/Calendar/Skins. A preview of all the provided skins is available in our Live Examples. |
|
Description |
Type |
Change |
|
RadCalendar.RangeMinDate - you can no longer select the RangeMinDate value in a range (e.g. if you have a "20-25 June" range, you cannot select June 20). |
property |
Modified |
| RadCalendar.OutOfRangeSettingsID - Gets or sets the key ID of the specific RichUIDisplayInfo definition in the VisualSettings collection that will be applied to the days of the current month that are out of the valid range, specified by the RangeMinDate and RangeMaxDate properties. |
property |
New |
|
RadCalendar client-side events |
| OnDayRender - fired for every calendar day cell when the calendar is rendered as a result of client-side navigation. |
event |
New |
| OnDateClick - added event object argument for the client-side OnDateClick event |
event |
Modified |
Telerik RadCalendar v1.6
|
Description |
Type |
Change |
|
RadDatePicker.FocusedDate - gets or sets the date that the calendar uses for focusing itself whenever the DateInput component of the DatePicker is empty. Default is today's date. |
property |
New |
|
RadDatePicker client-side events |
|
OnPopupUpdating - fired only on calendar popup opening prior to the synchronization of the date in the calendar popup and the DateInput. |
event |
New |
| OnDateSelected(args) - fired whenever the selected date of the datepicker is changed. Get the old selected date via args.OldDate and the new selected date via args.NewDate. |
event |
New |
 |
There are some issues caused by making Telerik RadCalendar being compatible with ASP.NET AJAX. You can check them out in ASP.NET AJAX support topic. |
Telerik RadCalendar v1.0 - Telerik RadCalendar v1.0.2
Server-side API Changes
The following changes in the server-side API were introduced in Telerik RadCalendar control since v1.0 release:.
|
Description |
Type |
Change |
|
PreviwSelectorVisualSettingsID was renamed to PreviewSelectorVisualSettingsID due to typo in the property name |
property |
Rename |
|
FastNavigationSettings |
property |
New |