spellcheck32 1.0.4-alpha
This is a prerelease version of spellcheck32.
There is a newer prerelease version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package spellcheck32 --version 1.0.4-alpha
NuGet\Install-Package spellcheck32 -Version 1.0.4-alpha
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="spellcheck32" Version="1.0.4-alpha" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add spellcheck32 --version 1.0.4-alpha
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: spellcheck32, 1.0.4-alpha"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install spellcheck32 as a Cake Addin #addin nuget:?package=spellcheck32&version=1.0.4-alpha&prerelease // Install spellcheck32 as a Cake Tool #tool nuget:?package=spellcheck32&version=1.0.4-alpha&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
spellcheck32
A .NET wrapper around the Microsoft Spell Checking API
Example
string text = "Cann I I haev some Linux?";
using SpellChecker spellChecker = new("en-US");
spellChecker.AutoCorrect("Linux", "Windows");
Console.WriteLine(string.Concat("Check \"", text, "\"", Environment.NewLine));
foreach (SpellingError error in spellChecker.Check(text))
{
string mistake = text.Substring(error.StartIndex, error.Length);
switch (spellingError.CorrectiveAction)
{
case CorrectiveAction.Delete:
Console.WriteLine(string.Concat("Delete \"", mistake, "\"", Environment.NewLine));
break;
case CorrectiveAction.GetSuggestions:
Console.WriteLine(string.Concat("Suggest replacing \"", mistake, "\" with:"));
foreach (string suggestion in spellChecker.Suggest(mistake))
{
Console.WriteLine(string.Concat("\"", suggestion, "\""));
}
Console.WriteLine(string.Empty);
break;
case CorrectiveAction.Replace:
Console.WriteLine(
string.Concat("Replace \"", mistake, "\" with \"",
spellChecker.Suggest(mistake).First(), "\"", Environment.NewLine));
break;
case CorrectiveAction.None:
default:
break;
}
}
Output:
Check "Cann I I haev some Linux?"
Replace "Cann" with "Can"
Delete "I"
Replace "haev" with "have"
Replace "Linux" with "Windows"
API
namespace spellcheck32;
public class SpellChecker
{
/// <summary>
/// Occurs when there is a change to the state of the spell checker that could cause the text to be treated differently. A
/// client should recheck the text when this event is received.
/// </summary>
public event EventHandler<EventArgs>? SpellCheckerChanged;
/// <summary>
/// Gets the identifier of the spell checker.
/// </summary>
public string Id { get; }
/// <summary>
/// Gets the BCP47 language tag this instance of the spell checker supports.
/// </summary>
public string LanguageTag { get; }
/// <summary>
/// Gets text, suitable to display to the user, that describes this spell checker.
/// </summary>
public string LocalizedName { get; }
/// <summary>
/// Creates a new instance of the <see cref="SpellChecker"/> class.
/// </summary>
/// <param name="languageTag">
/// A BCP47 language tag that identifies the language for the requested spell checker.
/// </param>
public SpellChecker(string languageTag)
/// <summary>
/// Treats the provided word as though it were part of the original dictionary.
/// </summary>
/// <remarks>
/// <para>
/// The word will no longer be considered misspelled, and will also be considered as a candidate for suggestions.
/// </para>
/// </remarks>
public void Add(string word)
/// <summary>
/// Causes the occurrences of one word to be replaced by another.
/// </summary>
/// <param name="from">
/// The incorrectly spelled word to be autocorrected.
/// </param>
/// <param name="to">
/// The correctly spelled word that should replace <paramref name="from"/>.
/// </param>
public void AutoCorrect(string from, string to)
/// <summary>
/// Checks the spelling of the supplied text and returns a collection of spelling errors.
/// </summary>
public IEnumerable<SpellingError> Check(string text)
/// <summary>
/// Checks the spelling of the supplied text in a more thorough manner than <see cref="Check(string)"/>, and returns a
/// collection of spelling errors."/>
/// </summary>
public IEnumerable<SpellingError> ComprehensiveCheck(string text)
/// <summary>
/// Ignores the provided word for the rest of this session.
/// </summary>
/// <remarks>
/// <para>
/// The word will no longer be considered misspelled, but it will not be considered as a candidate for suggestions.
/// </para>
/// </remarks>
public void Ignore(string word)
/// <summary>
/// Determines whether the specified language is supported by a registered spell checker.
/// </summary>
/// <param name="languageTag">
/// A BCP47 language tag that identifies the language for the requested spell checker.
/// </param>
/// <returns>
/// <see langword="true"/> if the specified language is supported by a registered spell checker, otherwise
/// <see langword="false"/>.
/// </returns>
public bool IsLanguageSupported(string languageTag)
/// <summary>
/// Registers a file to be used as a user dictionary for the current user, until unregistered.
/// </summary>
/// <remarks>
/// <para>
/// Allows clients to persistently register and unregister user dictionary files that exist in locations other than the
/// usual directory path (%AppData%\Microsoft\Spelling). The dictionaries must have the same files formats as the ones
/// located in the normal path and also should have the appropriate file extensions. However, it is strongly recommended
/// for clients to place their dictionaries under %AppData%\Microsoft\Spelling whenever it is possible--the spell checking
/// functionality does not pick up changes in dictionaries outside that directory tree.
/// </para>
/// <para>
/// The filename must have the extension .dic (added words), .exc (excluded words), or .acl (autocorrect word pairs). The
/// files are UTF-16 LE plaintext that must start with the aprropriate Byte Order Mark (BOM). Each line conains a word (in
/// the Added and Excluded word lists), or an autocorrect pair with the words separated by a vertical var ("|") (in the
/// AutoCorrect word list). The wordlist in which the dictionary is included is inferred through the file extension.
/// </para>
/// <para>
/// A file registered for a language subtag will be picked up for all languages that contain it. For example, a dictionary
/// registered for "en" will also be used by an "en-US" spell checker.
/// </para>
/// </remarks>
public void RegisterUserDictionary(string dictionaryPath, string languageTag)
/// <summary>
/// Removes a word that was previously added by <see cref="Add(string)"/>, or set by <see cref="Ignore(string)"/> to be
/// ignored.
/// </summary>
public void Remove(string word)
/// <summary>
/// Retrieves spelling suggestions for the supplied text.
/// </summary>
public IEnumerable<string> Suggest(string word)
/// <summary>
/// Gets the set of languages/dialects supported by any of the registered spell checkers.
/// </summary>
public IEnumerable<string> SupportedLanguages()
/// <summary>
/// Unregisters a previously registered user dictionary. The dictionary will no longer be used by the spell checking
/// functionality.
/// </summary>
/// <remarks>
/// <para>
/// To unregister a given file, this method must be passed the same arguments that were previously used to register it.
/// </para>
/// </remarks>
public void UnregisterUserDictionary(string dictionaryPath, string languageTag)
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.6-alpha | 61 | 5/23/2024 |
1.0.5-alpha | 70 | 5/5/2024 |
1.0.4-alpha | 83 | 1/16/2024 |
1.0.3-alpha | 65 | 1/16/2024 |
1.0.2-alpha | 51 | 1/16/2024 |
1.0.1-alpha | 79 | 1/6/2024 |
1.0.0-alpha | 78 | 1/5/2024 |