Navigate2 Method

---

Navigates to the resource identified by a Universal Resource Locator (URL) or to the file identified by a full path. The Navigate2 method extends the Navigate method to support browsing on special folders—such as Desktop and My Computer—that are represented by a pointer to an item identifier list (PIDL). However, this is not applicable to the Visual Basic® programming language. For information on this functionality, see the Using the WebBrowser Control from C/C++ section.

Syntax

object.Navigate2 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 of the resource to display or the full path to the file location.

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

Applies To

InternetExplorer, WebBrowser

See Also

Navigate