Click here to Skip to main content
15,311,151 members
Articles / Web Development / ASP.NET
Posted 21 Oct 2003


178 bookmarked

NetSpell - Spell Checker for .NET

Rate me:
Please Sign up or sign in to vote.
4.89/5 (50 votes)
21 Oct 200310 min read
The NetSpell project is a spell checking engine written entirely in managed C# .NET code.



The NetSpell project is a spell checking engine written entirely in managed C# .NET code.  NetSpell's suggestions for a misspelled word are generated using phonetic (sounds like) matching and ranked by a typographical (looks like) score.  NetSpell supports multiple languages and the dictionaries are based on the OpenOffice Affix compression format. The library can be used in Windows or Web Form projects. The download includes an English dictionary with dictionaries for other languages available for download on the project web site. NetSpell also supports user added words and automatic creation of user dictionaries. It also includes a dictionary build tool to build custom dictionaries.

The Dictionary

The root of all spell checkers is a word list, aka the dictionary.  The dictionary contains a list of common words for a language.  For example, the US English dictionary that comes with this package contains 162,573 words.

When designing the dictionary for NetSpell I wanted the dictionary to be a single file, be as small as possible and load extremely fast. I experimented with many different ways to save and load the large word lists.  Techniques I tried ranged from a saved dataset to a binary serialized collection, all of which proved to be too slow. I ended up using the good old UTF8 text file. Loading and parsing a text file proved to be extremely fast.

Affix Compression

The first issue I wanted to tackle was the file size.  Any compression scheme would have to decompress really fast. I first tried using zip.  While the dictionary loaded in the one second range, it was still not fast enough to be used in a web environment.

My research into spell checkers turned up a popular technique called Affix Compression.  Affix Compression is using a base word and adding prefixes and suffixes to it to create other words.  The affix compression scheme was originally developed by Geoff Kuenning for his ISpell spell checker. The OpenOffice project expanded the Affix Compression scheme to simplify its rule definitions.  The NetSpell Affix implementation is largely based on the OpenOffice MySpell format.  Read the following link to better understand Affix Compression format.

As a result of using the OpenOffice dictionary format, NetSpell dictionaries are easily created from OpenOffice dictionaries.  This allows NetSpell to easily support additional languages.  The NetSpell download includes a dictionary build tool that allows you to create new dictionaries.  The build tool also allows you to import OpenOffice dictionaries and save them to the NetSpell format.

Dictionary Sections

To satisfy the goal of making the dictionary a single file, I needed a way to separate different sections of the file. This would allow for storing different types of data as a word list was not the only data need to be stored.  I decided to use the INI section format. I thought about using XML but XML carries a large weight in terms of file size because of the use of tags.  I ended up with the following sections in the file.

The Copyright section contains any copyright information about the word list for the particular dictionary.

The try section contains a sequence of letters that are used to try to make a correct word out of a misspelled word. They should be listed on a single line in order of character frequency (highest to lowest).  This section is used by the Near Miss Strategy discussed later.

The replace section contains a sequence of letter combinations that are often misspelled, for example ei and ie.  The data is entered in this section in a search characters space replace characters format.  The ei, ie example would look like this in the dictionary, "ei ie". This section is used by the Near Miss Strategy discussed later.

The prefix section is used to define a set of affix rules for prefixes that can be attached to the beginning of a base word to form other words.  The format of these rules follows the same format as OpenOffice's affix files except the PFX is removed. You can read more about the OpenOffice affix format here

The suffix section is used to define a set of affix rules for suffixes that can be attached to the end of a base word to form other words.  The format of suffix rules follows the same format as OpenOffice's affix files except the SFX is removed. You can read more about the OpenOffice affix format here

The phonetic section is optional and it contains a set of rules that define how to generate a phonetic code for a character or set of characters.  The phonetic code is generated using Lawrence Philips' Metaphone Algorithm that has been adapted to a table format by the ASpell project.  The NetSpell dictionary uses the same format that ASpell uses.  ASpell phonetic maps can be used directly by NetSpell.  See the following link to learn more about the ASpell phonetic code.

The words section is the list of base words for the dictionary.  The format for this section is word/affix keys/phonetic code.  The affix keys and phonetic code portions are optional.  The affix keys portion indicates which affix rules apply to this word.  The phonetic code portion is a cache of the phonetic code for this word and is used by the phonetic suggestion strategy. 

Another important thing to know about dictionaries are that they are named to match the .NET Framework CultureInfo.Name property.  For example the US English dictionary is named "en-US.dic".  The en-US match the CultureInfo.Name property.  This allows the NetSpell library to default to the dictionary that corresponds to the computer's regional settings.

Spell Checking Text

Spell checking is normally performed by searching the dictionary for the given word.  Now that we've implemented affix compression, searching for the word became more complicated.  We have to create base words out of the given word. The process goes like this, first the base word list is searched for the given word.  If the word is not found in the base word list, the suffix rules are removed from the word.  After a suffix is removed, then the new word is checked to see if it is in the base word list.  If the word is still not found, the same process is repeated for the prefixes. If the word can't be found after removing the suffixes and prefixes, then the word is not found in the dictionary and is most likely misspelled.

Generating Suggestions

Once it has been determined that the word is misspell, we need to generate suggestions for the correct spelling of that word.  This is where the magic of a spell checker happens. NetSpell uses two different techniques to generate suggestions.  The first was developed by Geoff Kuenning for ISpell and is commonly called the near miss strategy. The second is Lawrence Philips' Metaphone Algorithm which returns a code that is a rough approximation of how an English word sounds.

Near Miss Strategy

The near miss strategy is a fairly simple way to generate suggestions.  Near miss takes the approach that the user didn't necessarily misspell the word but rather they mistyped it.  Two words are considered near if they can be made identical by inserting a blank space, interchanging two adjacent letters, changing one letter, deleting one letter or adding one letter. If a valid word is generated using these techniques, then it is added to the suggestion list. As you might have guessed, the near miss strategy doesn't provide the best list of suggestions when a word is truly misspelled.  That is where the phonetic strategy kicks in.

Phonetic Strategy

To understand the phonetic strategy, phonetic code needs to be defined.  A phonetic code is a rough approximation of how the word sounds.  Each character in the code represents a sound.  It's important to also understand that the phonetic code does not indicate how to pronounce the word; it's only a representation of how it sounds.

The phonetic strategy is comparing the phonetic code of the misspelled word to all the words in the word list.  If the phonetic codes match, then the word is added to the suggestion list.

While that process may sound strait forward, it becomes much more complicated when affix compression is introduced.  An affix compressed word list only contains base words.  We can't just compare the phonetic code of the misspelled word to the word list because the misspelled word may or may not be a base word.  To solve this issue, we remove all affix rules that pass the conditions of the rule from the misspelled word and add the resulting string to a possible base word list.  An important note to keep in mind is that the possible base word list is not a list of real words.  It is only a list of strings that can be made by removing the affix rules from the misspelled word.

Now that we have a list of possible base words from the misspelled word, we can generate the phonetic code on them and compare those codes with the list of base words.  If one of the codes matches the base word code, we add that word to the list of suggestion.  Since we removed all the affix keys and we compared only the base words, an expanded base word could be the correct word.  So, we expand the base word that matched by applying all the affix rules to get a list of all the possible words from that base word. We then add that list to the suggestion list.

Ranking Suggestions

Once we have a list of suggestions, we need some way to rank them by the most likely to be the correct spelling. My research into the best way to go about this turned up the Edit Distance Algorithm.  The edit distance is defined as the smallest number of insertions, deletions, and substitutions required changing one string into another. The NetSpell Edit Distance Algorithm implementation has one slight modification in that it adds an extra edit distance if the first character and last character don't match.  The rational behind this is that people generally can get the first character and last character correct when trying to spell a word.

Using the Library

To use the NetSpell Library in your project you simply add a reference to NetSpell.SpellChecker.dll to the project.  You can also add the library to the Visual Studio Toolbox to make it easier to interact with the properties. The library is event based so you have to handle the various events.  Also, if you set the ShowDialog property to true, the library will use its internal suggestion form to display the suggestion when a MisspelledWord event occurs.

The following code is a very simple implementation of the NetSpell library.

internal System.Windows.Forms.RichTextBox Document;
internal NetSpell.SpellChecker.Spelling SpellChecker;

// add event handlers
this.SpellChecker.MisspelledWord += 
                new NetSpell.SpellChecker.Spelling.MisspelledWordEventHandler(
this.SpellChecker.EndOfText += 
                     new NetSpell.SpellChecker.Spelling.EndOfTextEventHandler(
this.SpellChecker.DoubledWord += 
                   new NetSpell.SpellChecker.Spelling.DoubledWordEventHandler(

private void SpellChecker_DoubledWord(object sender, 
                                 NetSpell.SpellChecker.SpellingEventArgs args)
    // update text
    this.Document.Text = this.SpellChecker.Text;

private void SpellChecker_EndOfText(object sender, 
                                    System.EventArgs args)
    // update text
    this.Document.Text = this.SpellChecker.Text;

private void SpellChecker_MisspelledWord(object sender, 
                                 NetSpell.SpellChecker.SpellingEventArgs args)
    // update text
    this.Document.Text = this.SpellChecker.Text;

// Start Spell Checking
SpellChecker.Text = this.Document.Text;

The project download includes two example application for the NetSpell Library.  The first is a Windows forms text editor.  The second is a web project that demonstrats using the library in a web enviroment.


The NetSpell project has been a fun and challenging project to work on.  I plan to continue to improve and add new features to the library.  The feature that I'm currently working on is real time spell checking, like MS Word.  Please feel free to contact me with any suggestions, bug reports and feature request.

Paul Welter

References and Credits


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Paul Welter
Software Developer (Senior)
United States United States
No Biography provided

Comments and Discussions

QuestionMisspelled word Pin
Member 1471044015-Jan-20 22:44
MemberMember 1471044015-Jan-20 22:44 
Questionwindow colour Pin
Member 1119116712-Nov-15 21:23
MemberMember 1119116712-Nov-15 21:23 
Questionproblems importing Pin
Member 1119116727-May-15 12:14
MemberMember 1119116727-May-15 12:14 
QuestionIf dictionaries are UTF8 text, how can you support German, Spanish? Pin
Marc W9-Apr-14 0:24
MemberMarc W9-Apr-14 0:24 
AnswerRe: If dictionaries are UTF8 text, how can you support German, Spanish? Pin
Marc W9-Apr-14 1:42
MemberMarc W9-Apr-14 1:42 
QuestionHOW TO SWITCH Uk English. Pin
Anto Reegan14-Oct-13 20:27
MemberAnto Reegan14-Oct-13 20:27 
AnswerRe: HOW TO SWITCH Uk English. Pin
Marc W10-Apr-14 23:58
MemberMarc W10-Apr-14 23:58 
GeneralMy vote of 5 Pin
Tim Golisch13-Aug-13 4:19
MemberTim Golisch13-Aug-13 4:19 
Questionen-GB.dic Dictionary Pin
John L Bird15-Apr-13 2:45
MemberJohn L Bird15-Apr-13 2:45 
AnswerRe: en-GB.dic Dictionary Pin
v.sara16-Apr-13 19:48
Memberv.sara16-Apr-13 19:48 
GeneralRe: en-GB.dic Dictionary Pin
John L Bird16-Apr-13 23:01
MemberJohn L Bird16-Apr-13 23:01 
Questionwhere the new words added by user stored? Pin
Ahmed Khan8-Feb-12 7:58
MemberAhmed Khan8-Feb-12 7:58 
AnswerRe: where the new words added by user stored? Pin
revitarkitek18-Oct-19 10:51
Memberrevitarkitek18-Oct-19 10:51 
Generaldictionaries Pin
mahesh152925-May-10 3:24
Membermahesh152925-May-10 3:24 
QuestionConvert to VB.Net? Pin
ishadow25-Mar-10 9:34
Memberishadow25-Mar-10 9:34 
AnswerRe: Convert to VB.Net? Pin
jase_02426-Apr-10 10:02
Memberjase_02426-Apr-10 10:02 
Questiondictionary file type supported by the netspell checker? Pin
snangliya8-Feb-10 5:02
Membersnangliya8-Feb-10 5:02 
GeneralMultiple Text Boxes Pin
shortdog23-Oct-09 7:23
Membershortdog23-Oct-09 7:23 
GeneralRe: Multiple Text Boxes Pin
shortdog26-Oct-09 5:04
Membershortdog26-Oct-09 5:04 
GeneralRe: Multiple Text Boxes Pin
dmofo13-Nov-09 6:07
Memberdmofo13-Nov-09 6:07 
GeneralThread safety Pin
Stonkie2-Oct-09 7:00
MemberStonkie2-Oct-09 7:00 
GeneralUnderlining word style Pin
jammmie9996-Jun-09 21:44
professionaljammmie9996-Jun-09 21:44 
GeneralRe: Underlining word style [modified] Pin
Anthony Daly16-Aug-09 5:17
MemberAnthony Daly16-Aug-09 5:17 
GeneralRe: Underlining word style Pin
dmofo13-Nov-09 6:09
Memberdmofo13-Nov-09 6:09 
AnswerRe: Underlining word style [modified] Pin
Anthony Daly7-Feb-10 4:04
MemberAnthony Daly7-Feb-10 4:04 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.