Navigate Method

---

Navigates to the resource identified by a Universal Resource Locator (URL) or to the file identified by a full path.

Syntax

object.Navigate URL [Flags,] [TargetFrameName,] [PostData,] [Headers]

Parameters

object

Required. An object expression that evaluates to an object in the Applies To list.

URL

Required. A string expression that evaluates to the URL, full path, or Universal Naming Convention (UNC) location and name of the resource to display.

Flags

Optional. A constant or value that specifies whether to add the resource to the history list, whether to read from or write to the cache, and whether to display the resource in a new window. It can be a combination of the following constants or values.

navOpenInNewWindow	1	Open the resource or file in a new window.
navNoHistory	2	Do not add the resource or file to the history list. The new page replaces the current page in the list.
navNoReadFromCache	4	Do not read from the disk cache for this navigation.
navNoWriteToCache	8	Do not write the results of this navigation to the disk cache.

TargetFrameName

Optional. String expression that evaluates to the name of an HTML frame in URL to display in the browser window. The possible values for this parameter are:

_BLANK	Load the link into a new unnamed window.
_PARENT	Load the link into the immediate parent of the document the link is in.
_SELF	Load the link into the same window the link was clicked in.
_TOP	Load the link into the full body of the current window.
<WINDOW_NAME>	A named HTML frame. If no frame or window exists that matches the specified target name, a new window is opened for the specified link.

PostData

Optional. Data to send to the server during the HTTP POST transaction. For example, the POST transaction is used to send data gathered by an HTML form to a program or script. If this parameter does not specify any post data, the Navigate method issues an HTTP GET transaction. This parameter is ignored if URL is not an HTTP URL.

Headers

Optional. A value that specifies additional HTTP headers to send to the server. These headers are added to the default Microsoft® Internet Explorer headers. The headers can specify things like the action required of the server, the type of data being passed to the server, or a status code. This parameter is ignored if URL is not an HTTP URL.

Remarks

The WebBrowser control or InternetExplorer object can browse to any location in the local file system, on the network, or on the World Wide Web. Use the Navigate method to tell the browser which location to browse to. By including a text box in your application, you can let the user specify the location to browse to and then pass the location to the Navigate method.

Applies To

InternetExplorer, WebBrowser

See Also

Navigate2