Page.SmartNavigation Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Caution
The recommended alternative is Page.SetFocus and Page.MaintainScrollPositionOnPostBack. http://go.microsoft.com/fwlink/?linkid=14202
Gets or sets a value indicating whether smart navigation is enabled. This property is deprecated.
public:
property bool SmartNavigation { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool SmartNavigation { get; set; }
[System.ComponentModel.Browsable(false)]
[System.Obsolete("The recommended alternative is Page.SetFocus and Page.MaintainScrollPositionOnPostBack. http://go.microsoft.com/fwlink/?linkid=14202")]
public bool SmartNavigation { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.SmartNavigation : bool with get, set
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("The recommended alternative is Page.SetFocus and Page.MaintainScrollPositionOnPostBack. http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.SmartNavigation : bool with get, set
Public Property SmartNavigation As Boolean
Property Value
true
if smart navigation is enabled; otherwise, false
.
- Attributes
Remarks
In most circumstances, do not set this property in code. Set the SmartNavigation
attribute to true
in the @ Page directive in the .aspx file. When the page is requested, the dynamically generated class sets this property.
Note
In ASP.NET version 2.0, the SmartNavigation property is deprecated. Use the SetFocus method and the MaintainScrollPositionOnPostBack property instead.
When a page is requested by Microsoft Internet Explorer 5.5 browser, or later, smart navigation enhances the user's experience of the page by performing the following:
Eliminating the flash caused by navigation.
Persisting the scroll position when moving from page to page.
Persisting element focus between navigations.
Retaining only the last page state in the browser's history.
Smart navigation is best used with ASP.NET pages that require frequent postbacks but with visual content that does not change dramatically on return. Consider this carefully when deciding whether to set this property to true
.