This documentation is archived and is not being maintained.

WebBrowser::Navigate Method (Uri, Boolean)

Loads the document at the location indicated by the specified Uri into a new browser window or into the WebBrowser control.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

void Navigate(
	Uri^ url, 
	bool newWindow


Type: System::Uri
A Uri representing the URL of the document to load.
Type: System::Boolean
true to load the document into a new browser window; false to load the document into the WebBrowser control.


This WebBrowser instance is no longer valid.


A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.


The url parameter value does not represent an absolute URI. For more information, see Uri::IsAbsoluteUri.

The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. When you call this overload with a newWindow parameter value of false, the control navigates to the specified URI normally and adds the URI to the end of the history list. When you call this overload with a newWindow parameter value of true, the WebBrowser control loads the document at the specified URI into a new Internet Explorer window, which maintains its own navigation history. You can handle the NewWindow event to receive notification before a new browser window is opened, allowing you to cancel the action if necessary.

The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Each page can specify an expiration date indicating how long it will remain in the cache. When the control navigates to a page or loads a page into a separate browser window, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version. When a page is loaded into a separate Internet Explorer window, the user can retrieve the latest version by clicking the Refresh button.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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