Installation Guide

1.Downloading the software

AspNetSpell can be downloaded from www.aspnetspell.com as a zip file.

When you have downloaded the package, unzip it to a convenient location on your hard disk for future use.

There are 2 main sets of files that you have downloaded:

AspNetSpell.dll 

Add this to your Visual Studio toolbox. (see below)

A Directory of files labeled AspNetSpell

Copy and paste this to the root folder of your website project (see below).   You do not need to add this to the application in Visual Studio.

 

2. Adding AspNetSpell to the Visual Studio ToolBox

Visual Studio .Net 2002/2003

Right click on the Visual Studio 2005 ToolBox and pick "Add/Remove Items...".  In the new dialog, click "Browse...", then pick the AspNetSpell.dll which you downloaded and click "OK".  You now have drag-and-drop access to AspnetSpell for web application development.

Visual Studio 2005 / 2008

Right click on the Visual Studio 2005 ToolBox and pick "Choose Items...".  In the new dialog, click "Browse...", then pick the AspNetSpell.dll which you downloaded and click "OK".  You now have drag-and-drop access to AspNetSpell for web application development.

 

3. Installing the AspNetSpell Directory to your Web Project

After dragging the AspNetSpell component onto a web form, you must copy the downloaded directory AspNetSpell into the root folder of your website (You do not have to add these files to the Visual Studio solution). You will be warned at runtime if this operation is not successful.

If this location is inconvenient, you can specify another URL for the files using the InstallPath property.

 

4. Using the spell checker for the first time

One you have dragged AspNetSpell into your webs form, and installed the AspNetSpell directory properly, you are ready to start spell checking.

To select the field(s) that AspNetSpell will spell check, change the FieldsToSpellCheck property.  This can refer to a TextBox, or a rich Editor such as FCK.net or ActiveUp Editor.

E.g.   FieldsToSpellCheck  = 'textBox1';

FieldsToSpellCheck can also be set to a list of fields to be spellchecked together.

E.g.   FieldsToSpellCheck  = 'textBox1,textBox2';

For detailed information of configuring AspNetSpell, please refer to the object reference . 

 

5. Server Issues (particularly for Visual Studio 2005 / 2008)

If you have a "file system" based web project then the spell checker will not work until uploaded to an IIS web server.  Note that the server must have support for ASP Classic as well as ASP.Net.

Turning on Classic ASP Support in Server 2003
Go to Control Panel > Add/Remove programs >Add/Remove Windows Components > Application Server > IIS

Turning on Classic ASP Support in Windows Vista
Go to Control Panel > Programs > Turn Windows features on or off > Internet Information Services > World Wide Web Services > Application Development Features. Turn on ASP, Request Filtering and ISAPI Extensions.

Turning on Classic ASP Support in Server 2008
Go to Start > Administrative Tools > Server Manager > Roles > Web Server (IIS) > Add Role Services > Application Development. Turn on ASP, Request Filtering and ISAPI Extensions.

IIS 7 - Turning on Classic ASP as a Service
You may also need to turn on the Classic ASP feature in IIS7. Start > Administrative Tools > Computer Management

Read more from Microsoft TechNet.

6. Installing Dictionaries

The dictionary language which the spellchecker will use is set by the Dictionary property.

To install dictionaries - you must first download them from www.aspnetspell.com. 

The value of the Dictionary property should match the file name (excluding the .dic extension).  Possible values include:

• "Deutsch" - for German
• "English (Australia)" - for Australian English
• "English (Canada)" - for Canadian English
• "English (International)" - for International English
• "English (UK)" - for British English
• "English (USA)" - for USA American English
• "Espanol" - for Spannish
• "Francais"  - for French
• "Italiano" - for Italian
• "Nederlands" - for Dutch
• "Portugues" - for Portuguese
• "Svenska" - for Swedish
• "Dansk" - For Danish
  

To use multiple dictionaries you can use a comma Separated list. E.g. :  "English (Canada), Francais"

You can also encode you or dictionaries using the dictionary encoders (also downloadable from www.aspnetspell.com).

In addition, you can add words to the list by putting them in the file AspNetSpell/Dictionaries/custom.txt .  Put 1 word per line, preferably in alphabetical order for performance issues.  This sorting can be achieved using software like MS Excel or EditPlus.

To change the language of spellchecker dialogs and buttons please see DialogLanguage in the object reference .

 

7. Registration

To register AspNetSpell for commercial use, please refer to the registration guide.