WebBrowser.Navigate Method (Uri, String, Byte[], String) (System.Windows.Forms)

.NET Framework Class Library

WebBrowser..::.Navigate Method (Uri, String, array<Byte>[]()[], String)

Loads the document at the location indicated by the specified Uri into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

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

Syntax

Visual Basic (Declaration)

Public Sub Navigate ( _
    url As Uri, _
    targetFrameName As String, _
    postData As Byte(), _
    additionalHeaders As String _
)

Visual Basic (Usage)

Dim instance As WebBrowser
Dim url As Uri
Dim targetFrameName As String
Dim postData As Byte()
Dim additionalHeaders As String

instance.Navigate(url, targetFrameName, _
    postData, additionalHeaders)

public void Navigate(
    Uri url,
    string targetFrameName,
    byte[] postData,
    string additionalHeaders
)

Visual C++

public:
void Navigate(
    Uri^ url, 
    String^ targetFrameName, 
    array<unsigned char>^ postData, 
    String^ additionalHeaders
)

JScript

public function Navigate(
    url : Uri, 
    targetFrameName : String, 
    postData : byte[], 
    additionalHeaders : String
)

Parameters

url: Type: System..::.Uri
A Uri representing the URL of the document to load.

targetFrameName: Type: System..::.String
The name of the frame in which to load the document.

postData: Type: array<System..::.Byte>[]()[]
HTTP POST data such as form data.

additionalHeaders: Type: System..::.String
HTTP headers to add to the default headers.

Exceptions

Exception	Condition
ObjectDisposedException	This WebBrowser instance is no longer valid.
InvalidOperationException	A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.
ArgumentException	The url parameter value does not represent an absolute URI. For more information, see Uri..::.IsAbsoluteUri.

Remarks

The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Use the GoBack method to return the control to a previous page in the navigation history. Use the GoForward method to return to a later page in the navigation history after navigating backward.

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, 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.

.NET Framework Security

SecurityPermission
for immediate callers to use this control. Demand value: LinkDemand; Named Permission Sets: FullTrust.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

WebBrowser Class

WebBrowser Members

Navigate Overload

System.Windows.Forms Namespace

GoBack

GoForward

Refresh

Other Resources

IWebBrowser2 Interface