Page.SmartNavigation Property

Definition

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.

Applies to

See also