HTML Editor for ASP.NET AJAX

Basic Edition
Readme

Version 1.9.5

License

The license agreement is contained in License.htm.

Introduction

This control is designed specifically for ASP.NET AJAX.

Features
  • Server control implements IScriptControl
  • Client control extends Sys.UI.Control
  • Self-contained with resources embedded in the assembly
  • Configuration and Event properties exposed through Visual Studio
Getting Started

The zip file should be extracted to a new folder. For both ASP.NET 2.0 (Visual Studio 2005) and ASP.NET 3.5 (Visual Studio 2008) configurations, it includes:

  • The Winthusiasm.HtmlEditor control project
  • A sample website that uses the HtmlEditor control
  • A solution that contains both

System Requirements

If ASP.NET 2.0 is installed
  • ASP.NET AJAX Extensions 1.0 must be installed
  • Site must be ASP.NET AJAX enabled
If ASP.NET 3.5 is installed
  • Site must be ASP.NET AJAX enabled
Supported Browsers
  • Internet Explorer 6+
  • Firefox 1.5+
  • Opera 9+

Included Folders and Files

The zip file includes separate folders for ASP.NET 2.0 and ASP.NET 3.5 configurations. Each configuration folder also contains an appropriate solution file.

Release Folder
  • Winthusiasm.HtmlEditor.dll
Site Folder
  • Demo.aspx
  • Demo.aspx.cs
  • Web.config
Winthusiasm.HtmlEditor Folder
  • Source files for the Winthusiasm.HtmlEditor control project
Other
  • License.htm
  • Readme.htm

Using the Code

  1. Double-click the solution file to open the solution in Visual Studio 2005 or Visual Studio 2008
  2. Select Build/Rebuild Solution from the menu. This will build the project and copy the project DLL to the Bin folder of the sample website.
  3. Set Demo.aspx as the Start Page
  4. Press F5

Site Installation

Required Steps
  1. Copy Winthusiasm.HtmlEditor.dll to the Bin folder of your site
  2. Add a Register statement for the HtmlEditor to the top of the page
  3. Add a Custom Tag for the HtmlEditor to the page

Use Model

  1. Use the Text property to set the editor HTML
  2. Save the HTML when appropriate
  3. Use the Text property to get the "saved" HTML
Use Model Details: Saving the HTML when Appropriate

The editor's "client-side" Save method instructs the editor to store the current HTML (converting to XHTML if appropriate) and clears the modified flag. When the editor property AutoSave is set to true (the default), the client-side Save method is called automatically as part of the client-side ASP.NET validation process before the form is submitted. All controls with a CausesValidation property set to true (the default) trigger the behavior.

If the AutoSave implementation is not appropriate or sufficient, the client script to trigger the client-side Save can be attached through the optional SaveButtons property or manually.