New to Telerik UI for WinForms? Start a free 30-day trial

Stores custom spellings in isolated storage and can persist changes as they occur.

Definition

Constructors

Initializes the dictionary with the default storage scope and file name, loading any existing contents.

C#
public RadIsolatedStorageCustomDictionary()

Initializes the dictionary with the specified storage scope and file name, loading any existing contents.

C#
public RadIsolatedStorageCustomDictionary(IsolatedStorageScope storageScope, string customDictionaryName)
Parameters:storageScopeIsolatedStorageScope

The isolated-storage scope used for the dictionary file.

customDictionaryNamestring

The file name used to persist the dictionary.

Exceptions: NotSupportedException

The scope is not supported by the current platform.

Initializes the dictionary with the specified storage scope and the default file name.

C#
public RadIsolatedStorageCustomDictionary(IsolatedStorageScope storageScope)
Parameters:storageScopeIsolatedStorageScope

The isolated-storage scope used for the dictionary file.

Exceptions: NotSupportedException

The scope is not supported by the current platform.

Initializes the dictionary with the default storage scope and a custom file name.

C#
public RadIsolatedStorageCustomDictionary(string customDictionaryName)
Parameters:customDictionaryNamestring

The file name used to persist the dictionary.

Fields

Gets the default file name used to persist custom spellings.

C#
public static readonly string DefaultDictionaryName

Gets the default isolated-storage scope used by the parameterless constructor.

C#
public static readonly IsolatedStorageScope DefaultIsolatedStorageScope

Properties

Gets or sets whether changes are written to isolated storage immediately.

C#
public bool AutoUpdateIsolatedStorage { get; set; }
Property Value:

true to persist changes automatically; otherwise, call UpdateIsolatedStorage() to save them. The default value is true.

Methods

Adds the lowercased spelling if it is not already stored.

C#
public void AddWord(string word)
Parameters:wordstring

The spelling to add.

Implements: ICustomWordDictionary.AddWord(string)

When AutoUpdateIsolatedStorage is true, a successful addition is persisted immediately. The dictionary raises DataChanged only when a new spelling is added.

Removes all stored spellings.

C#
public void ClearWords()

Implements: ICustomWordDictionary.ClearWords()

When the dictionary contains spellings and AutoUpdateIsolatedStorage is true, the cleared contents are written to storage. If it was already empty, no write or change notification occurs.

Releases the isolated-storage file handle used by this dictionary.

C#
public void Dispose()

Implements: IDisposable.Dispose()

Removes the lowercased spelling when it is present.

C#
public void RemoveWord(string word)
Parameters:wordstring

The spelling to remove.

Implements: ICustomWordDictionary.RemoveWord(string)

When AutoUpdateIsolatedStorage is true, a successful removal is persisted immediately. The dictionary raises DataChanged only when a spelling is removed.

Writes the current custom spellings to the isolated-storage file, replacing its previous contents.

C#
public void UpdateIsolatedStorage()