.NET and .NET Framework

TX Spell .NET for WPF works in two kinds of projects: projects for .NET 8 or higher, which get TX Spell .NET from NuGet packages, and projects for the .NET Framework, which reference the assemblies the setup installs. The API is the same in both. What differs is how the files, the license and the language data reach your project, and the right choice depends on the framework your application targets.

Supported Versions

Text Control names .NET 8, .NET 9 and the .NET 10 preview for version 11.0, and its blog article about the Document Editor on Linux uses .NET 10. Projects for .NET 5, .NET 6 and .NET 7 used the package of version 10.0. The packages of version 11.0 need .NET 8 or higher, so move such a project to .NET 8 or higher before you update; Breaking Changes lists this change.

Microsoft supports each .NET version for a limited time. The .NET support policy shows which versions receive updates.

.NET 8 or Higher

In a project for .NET 8 or higher, you install the package from the package source Text Control Offline Packages, which the setup provides. The package brings everything the project needs:

• The assemblies for .NET 8, with German resources.
• The license, as a license file that the build embeds into your assembly: txspell.wpf.license.
• The US English language data: the dictionary, the hyphenation list, the thesaurus and the language recognition data, which the build copies into the output folder.

Create Your First WPF Application walks through such a project, and Package Overview lists the contents of each package.

For code without a user interface, such as a service or a console application, the package TXTextControl.TXSpell.Core.SDK contains only the spell checking engine, the TXSpell class. It runs on Windows and on Linux; Checking Text in Code shows it.

.NET Framework

In a project for the .NET Framework, you reference the assemblies TXSpell.dll and TXSpell.WPF.dll from the Assembly folder of the TX Spell .NET installation. The language data is found in the same folder while you develop, and you ship it with the application. The license reaches the application through the project's licenses.licx file. Create a .NET Framework Application shows the steps, and Development Licenses the license entries.

The requirements of TX Spell .NET also name the .NET Framework 4.0, but TX Spell .NET for WPF has required the .NET Framework 4.5 or higher since version 7.0. The tutorial Create a .NET Framework Application uses the .NET Framework 4.8.

Which One to Choose

• New applications use .NET 8 or higher, with the NuGet packages.
• Existing .NET Framework applications keep the assemblies of the setup. Migrating from .NET Framework to .NET describes the move when you are ready.
• Services and batch jobs that only check text use TXTextControl.TXSpell.Core.SDK on .NET 8 or higher.

Next Steps

• Windows Versions: where you develop and where your application runs.
• Visual Studio: the Visual Studio version and the project templates.
• Installing the Product: run the setup that provides the packages and the assemblies.