RadEditor for ASP.NET AJAX

RadControls for ASP.NET AJAX

Migration from RadEditor Classic to RadEditor for ASP.NET AJAX

You can find below the list of steps to migrate your web applications from the classic RadEditor to RadEditor for ASP.NET AJAX:

  1. To add RadEditor for ASP.NET AJAX to an existing ASP.NET web application you need to follow these steps:

    1. Make sure you have installed ASP.NET AJAX. Info can be found at http://ajax.asp.net/docs/InstallingASPNETAJAX.aspx

    2. If your web application is not using ASP.NET AJAX you need to configure it to do so. Detailed instructions can be found at http://ajax.asp.net/docs/ConfiguringASPNETAJAX.aspx (check the topic called Adding ASP.NET AJAX Configuration Elements to an Existing Web Site)

    3. Add a ScriptManager control to the page (or user control) in which you are going to add any RadControls for ASP.NET AJAX.<asp:ScriptManager ID="ScriptManager1" runat="server" />If your page is a content page you can add the ScriptManager control in your master page. For further details about the ScriptManager control you can check http://ajax.asp.net/docs/overview/ScriptManagerOverview.aspx.

  2. Drag and drop a control from the RadControls for ASP.NET AJAX package or manually copy the Telerik.Web.UI.dll in the Bin folder.

  3. Replace the classic RadEditor's directive

    <%@ Register Assembly="RadEditor.NET2" Namespace="Telerik.WebControls" TagPrefix="radE" %>

    with the new one of RadEditor for ASP.NET AJAX:

    <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %>

  4. Replace the classic RadEditor's declaration:

    <radE:RadEditor id="RadEditor1" Runat="server">Sample Content</radE:RadEditor>

    with the new RadEditor for ASP.NET AJAX declaration:

    <telerik:radeditor runat="server" Visible="false" ID="RadEditor1"> <Content> Sample content </Content> </telerik:radeditor>

  5. To enable the RadEditor's Dialogs follow the provided information in the following help article: Introduction to RadEditor's Dialogs.

  6. To enable RadSpell in RadEditor review the following help article: Enable RadSpell in RadEditor.

  7. The ConfigFile property is obsolete in RadEditor for ASP.NET AJAX, because the control can be easily configured to use ASP.NET 2.0 Themes the same way you would do for a ordinary asp.net control. Review the following help article for more information: Using Themes.

  8. RadEditor for ASP.NET AJAX produces out-of-the box Xhtml content. The Html and Xhtml properties are obsolete and replaced with a new property named Content.

  9. The SaveInFile property is removed. If you want to save the editor's content directly in the page with the editor review the solution in this article: Saving RadEditor for ASP.NET AJAX content directly in the ASPX or ASCX file containing the editor.

Changes in RadEditor for ASP.NET AJAX

Server-Side API: There have been big changes made here but we tried to provide as much backward compatibility as possible and keep the client-side API.The table below shows all the changed/removed and new properties in new RadEditor for ASP.NET AJAX:

 

Old Name

New Name

Type

Status

Html

Content

property

Replaced

Xhtml

n/a - use Content instead

Removed

ImagesPaths

ViewPaths

property

same for all editor dialogs

UploadImagesPaths

UploadPaths

property

same for all editor dialogs

DeleteImagesPaths

DeletePaths

property

same for all editor dialogs

SetPaths

n/a

method

Removed

UseClassicDialogs

set_useClassicDialogs(true) - new client-side method

property

new method

RenderAsTextArea

n/a

property

Removed

ShowHtmlMode

EditModes

property

Changed

ShowPreviewMode

EditModes

property

Changed

ShowSubmitCancelButtons

n/a

property

Removed

new property

OnClientSelectionChange

event

new event

new property

OnClientPasteHtml

new event

OnClientModeChange

add_modeChange()

event

new method

OnClientSubmit

not yet implemented

event

soon

OnClientCancel

n/a

event

Removed

HasPermission

Enabled

property

Replaced

Editable

n/a

property

Removed

AllowCustomColors

n/a

property

Removed

AllowScripts

RadEditor1.EnableFilter(EditorFilters.RemoveScripts);

property

new mothod

AllowThumbGeneration

n/a

property

Removed

CacheLocalization

n/a

property

Removed

ConfigFile

n/a - use Themes

property

Removed

CookieExpirationTime

n/a

property

Removed

EnableClientSerialize

n/a

property

Removed

EnableDocking

n/a

property

Removed

FocusOnLoad

n/a

property

Removed

StripFormattingOnPaste

StripFormattingOptions

enum

Changed

Client-Side API: All important properties are kept. Some of the unimportant properties have been removed. We have strived to provide maximal backward compatibility for an easy transition to the new editor.

 

Old Name

New Name

Type

Change

GetRadEditor()

$find()

method

Replaced

Document

get_document()

property/method

Fire()

fire()

method

Replaced

CancelEdit()

n/a

method

Removed

CreateRestorePoint()

createRestorePoint() - obsolete, use getSelection().getRange()

method

Replaced

GetContentArea()

get_contentArea()

method

Replaced

GetHeight()

editor.get_element().style.height

method

Replaced

GetWidth()

editor.get_element().style.width

method

Replaced

GetHtml()

get_html()

method

Replaced

GetMode()

get_mode()

method

Replaced

GetSelection()

getSelection()

method

Replaced

GetSelectionHtml()

getSelectionHtml()

method

Replaced

GetText()

get_text()

method

Replaced

GetToolByName()

getToolByName()

method

Replaced

SetHtml()

set_html()

method

Replaced

PasteHtml()

pasteHtml()

method

Replaced

SetFocus()

setFocus()

method

Replaced

SetMode()

set_mode()

method

Replaced

SetSize()

setSize()

method

Replaced

SetVisible()

set_visible()

method

Replaced

ShowDialog()

showExternalDialog()

method

Replaced

Submit()

add_submit()

method

Replaced

AttachEventHandler()

attachEventHandler()

method

Replaced

GetContentArea()

get_contentArea()

method

Replaced

GetTextArea()

get_textArea()

method

Replaced