Edit this page

Saving and Loading

The RadFilter server-side API offers two methods for saving and loading RadFilter expressions by user:

  • SaveSettings - serializes the control expressions to Base64 encoded string;

  • LoadSettings - Loads the provided state in the control. The parameter for this method must be * Base64 encoded * string representing saved control expressions.

You see how they work in the Save/Load RadFilter expressions live demo.

caution

All versions of RadFilter prior to Q3 2010 use the ObjectStateFormatter by default. Due to the nature of this formatter, it is not possible to deserialize settings, saved with different version of the assembly. From Q3 2010 on, the BinaryFormatter is set as default.

You could get or change the default formatter using the SettingsFormatter property (introduced in Q3 2010).

  • RadFilter.SettingsFormatter.BinaryFormatter - this is the default formatter for UI versions Q3 2010 and later. The advantage of this formatter is that it will work even if you save the state with one version of the assembly and then restore it with another. The drawback is that the BinaryFormatter does not work in medium trust.

  • RadFilter.SettingsFormatter.ObjectStateFormatter- the default formatter in UI versions prior to Q3 2010. This formatter works flawlessly in medium trust but it won't deserialize settings, saved with another version of the assembly.

It is possible to use your own formatter by overriding the GetSettingsFormatter method. For more information about the formatters, please visit the following link: IFormatter Interface (MSDN)