Specifies the level of control's state restoration.

Syntax

Visual Basic (Declaration)
<DefaultValueAttribute()> <DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")> <ISNet.Serialization.BinarySerializableAttribute()> <CategoryAttribute("Behavior")> <NotifyParentPropertyAttribute(True)> <ISNet.Serialization.XmlSerializableAttribute()> Public Property StateRestorationLevel As RestorationLevel

Visual Basic (Declaration)

<DefaultValueAttribute()>
<DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")>
<ISNet.Serialization.BinarySerializableAttribute()>
<CategoryAttribute("Behavior")>
<NotifyParentPropertyAttribute(True)>
<ISNet.Serialization.XmlSerializableAttribute()>
Public Property StateRestorationLevel As RestorationLevel

Visual Basic (Usage)	Copy Code
Dim instance As WebGrid Dim value As RestorationLevel instance.StateRestorationLevel = value value = instance.StateRestorationLevel

C#
[DefaultValueAttribute()] [DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")] [ISNet.Serialization.BinarySerializableAttribute()] [CategoryAttribute("Behavior")] [NotifyParentPropertyAttribute(true)] [ISNet.Serialization.XmlSerializableAttribute()] public RestorationLevel StateRestorationLevel {get; set;}

[DefaultValueAttribute()]
[DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")]
[ISNet.Serialization.BinarySerializableAttribute()]
[CategoryAttribute("Behavior")]
[NotifyParentPropertyAttribute(true)]
[ISNet.Serialization.XmlSerializableAttribute()]
public RestorationLevel StateRestorationLevel {get; set;}

Delphi
public read-write property StateRestorationLevel: RestorationLevel;

JScript
DefaultValueAttribute() DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.") ISNet.Serialization.BinarySerializableAttribute() CategoryAttribute("Behavior") NotifyParentPropertyAttribute() ISNet.Serialization.XmlSerializableAttribute() public function get,set StateRestorationLevel : RestorationLevel

JScript

DefaultValueAttribute()
DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")
ISNet.Serialization.BinarySerializableAttribute()
CategoryAttribute("Behavior")
NotifyParentPropertyAttribute()
ISNet.Serialization.XmlSerializableAttribute()
public function get,set StateRestorationLevel : RestorationLevel

Managed Extensions for C++
[DefaultValueAttribute()] [DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")] [ISNet.Serialization.BinarySerializableAttribute()] [CategoryAttribute("Behavior")] [NotifyParentPropertyAttribute(true)] [ISNet.Serialization.XmlSerializableAttribute()] public: __property RestorationLevel get_StateRestorationLevel(); public: __property void set_StateRestorationLevel( RestorationLevel value );

Managed Extensions for C++

[DefaultValueAttribute()]
[DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")]
[ISNet.Serialization.BinarySerializableAttribute()]
[CategoryAttribute("Behavior")]
[NotifyParentPropertyAttribute(true)]
[ISNet.Serialization.XmlSerializableAttribute()]
public: __property RestorationLevel get_StateRestorationLevel();
public: __property void set_StateRestorationLevel( 
   RestorationLevel value
);

C++/CLI
[DefaultValueAttribute()] [DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")] [ISNet.Serialization.BinarySerializableAttribute()] [CategoryAttribute("Behavior")] [NotifyParentPropertyAttribute(true)] [ISNet.Serialization.XmlSerializableAttribute()] public: property RestorationLevel StateRestorationLevel { RestorationLevel get(); void set ( RestorationLevel value); }

C++/CLI

[DefaultValueAttribute()]
[DescriptionAttribute("Specifies the level of control's state restoration. See help for more information.")]
[ISNet.Serialization.BinarySerializableAttribute()]
[CategoryAttribute("Behavior")]
[NotifyParentPropertyAttribute(true)]
[ISNet.Serialization.XmlSerializableAttribute()]
public:
property RestorationLevel StateRestorationLevel {
   RestorationLevel get();
   void set (    RestorationLevel value);
}

Remarks

This property controls the control's state restoration level which is very important to increase the performance of OnTheFly postback. The default value is High, means that state restoration will be performed as maximum as possible. With this setting, all client's states including static properties and dynamic objects will be sent to server on postback. You should switch to High mode especially when you are creating most of objects at runtime, such as retrieving structure at runtime, setting layoutsetting or setting textsettings at runtime.

The Medium value indicates that dynamic objects such as grouped columns, filtered columns and so on - which can be changed by user interactively - will be sent to server on postback, along with layoutsettings and table properties.

The Low value will sent as minimal state as possible to server. Only dynamic objects and important values that vital to the control are being sent and therefore this mode will increase the speed of OnTheFly postback dramatically. This mode is very suitable for grid that is created in design time and that most settings are specified in design time. Most developers preferred the best practice that is to take advantage of IDE design time capability to save time with less codes, such as retrieving hierarchical structure, setting grid's behavior, table properties and column properties. Users are recommended to switch to this level for maximum performance, which generally is 50% faster than High level restoration especially noticed when used in Internet zone application. Note that this mode will still work perfectly with all UI features and functionalities.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

Syntax

Remarks

Requirements

See Also

Reference

Intersoft WebGrid Documentation
StateRestorationLevel Property
See Also Send Feedback