Export (0) Print
Expand All

WebBrowser.CanGoBack Property

Note: This property is new in the .NET Framework version 2.0.

Gets a value indicating whether a previous page in navigation history is available, which allows the GoBack method to succeed.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public bool CanGoBack { get; }
/** @property */
public boolean get_CanGoBack ()

public function get CanGoBack () : boolean

Property Value

true if the control can navigate backward; otherwise, false.

The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. The GoBack method navigates the WebBrowser control to the previous page in this history, if one is available. Use the CanGoBack property to determine whether navigation history is available and contains a previous page. If this property is true, the GoBack method will succeed. Otherwise, calling the GoBack method will return a value of false and no navigation will occur.

You can also handle the CanGoBackChanged event to receive a notification when the CanGoBack property changes. Handling this event is useful, for example, to change the enabled state of a Back button when the WebBrowser control navigates to or leaves the beginning of the navigation history.

The following code example demonstrates how to use the CanGoBack property to implement a Back button for the WebBrowser control that is similar to the Back button in Internet Explorer. This example requires that your form contains a WebBrowser control called webBrowser1 and a Button control called ButtonBack.

For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

// Navigates webBrowser1 to the previous page in the history.
private void backButton_Click(object sender, EventArgs e)
{
    webBrowser1.GoBack();
}

// Disables the Back button at the beginning of the navigation history.
private void webBrowser1_CanGoBackChanged(object sender, EventArgs e)
{
    backButton.Enabled = webBrowser1.CanGoBack;
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

.NET Compact Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft