Click or drag to resize

INavigation Interface

Allows loading resources in the browser instance and working with the navigation history.

Namespace:  DotNetBrowser.Navigation
Assembly:  DotNetBrowser (in DotNetBrowser.dll) Version: 2.23.0
Syntax
C#
public interface INavigation : IAutoDisposable

The INavigation type exposes the following members.

Properties
  NameDescription
Public propertyBrowser
Gets the IBrowser instance associated with this object.
Public propertyCurrentEntry
Gets the current navigation item in the back-forward list.
Public propertyCurrentIndex
Gets the index of the current navigation item in the back-forward list.
Public propertyEntryCount
Gets the number of items in the back-forward list.
Public propertyIsDisposed
Indicates if the object is already disposed.
(Inherited from IAutoDisposable.)
Public propertyShowHttpErrorPageHandler
Gets or sets a handler that is used when the engine is about to display an error web page because the web server sends an empty HTTP response with the HTTP status code that represents an error.
Public propertyShowNetErrorPageHandler
Gets or sets a handler that is used when the engine is about to display a network error web page because the required web resource cannot be loaded because of a network error.
Public propertyStartNavigationHandler
Gets or sets a handler that is used before the browser starts navigation to a resource.
Top
Methods
  NameDescription
Public methodCanGoBack
Checks whether the previous location can be loaded.
Public methodCanGoForward
Checks whether the next location can be loaded.
Public methodEntryAt
Returns an INavigationEntry instance for the given index in the back-forward list.
Public methodGoBack
Loads the previous location in the back-forward list. It does nothing if there's no previous location in the list.
Public methodGoForward
Loads the next location in the back-forward list. It does nothing if there's no next location in the list.
Public methodGoTo
Navigates to a specific location at the given index in the back-forward list.
Public methodLoadUrl(String)
Navigates to a resource identified by a URL.
Public methodLoadUrl(LoadUrlParameters)
Navigates to a resource identified by the specified parameters
Public methodLoadUrl(String, TimeSpan)
Navigates to a resource identified by a URL, with the specified timeout.
Public methodLoadUrl(LoadUrlParameters, TimeSpan)
Navigates to a resource identified by the given LoadUrlParameters, with the specified timout.
Public methodReload
Reloads the currently loaded web page.
Public methodReloadAndCheckForRepost
Reloads the currently loaded web page. If the current web page has POST data, the user will be asked to confirm that he really wants to reload the page.
Public methodReloadIgnoringCache
Reloads the currently loaded web page ignoring the cached data.
Public methodReloadIgnoringCacheAndCheckForRepost
Reloads the currently loaded web page ignoring the cached data. If the current web page has POST data, the user will be asked to confirm that he really wants to reload the page.
Public methodRemoveEntryAt
Removes the item at the given index from the back-forward list and returns true if it was removed successfully.
Public methodStop
Cancels any pending navigation or download operation and stops any dynamic page elements, such as background sounds and animations.
Top
Events
  NameDescription
Public eventDisposed
Occurs when the object has been disposed.
(Inherited from IAutoDisposable.)
Public eventFrameDocumentLoadFinished
Occurs when the document loading in the given IFrame has been finished. At this point, deferred scripts were executed, and content scripts marked "document_end" get injected into the IFrame.
Public eventFrameLoadFailed
Occurs when the content load was failed.
Public eventFrameLoadFinished
Occurs when the content of the IFrame has been loaded completely.
Public eventLoadFinished
Occurs when the content loading has been finished. This event corresponds to the moment when the spinner of the tab stops spinning.
Public eventLoadProgressChanged
Occurs when the page has made some progress loading.
Public eventLoadStarted
Occurs when the content loading has been started. This event corresponds to the moment when the spinner of the tab starts spinning.
Public eventNavigationFinished
Occurs when the navigation has been finished. This happens when a navigation is committed, aborted, or replaced by a new one.
Public eventNavigationRedirected
Occurs when the navigation has encountered a server redirect.
Public eventNavigationStarted
Occurs when the navigation has been started. This is also fired by same-document navigations, such as fragment navigations or pushState/replaceState, which will not result in a document change. To filter these out, use the IsSameDocument property.

Note that more than one navigation can be ongoing in the same frame at the same time(including the main frame). Also, there is no guarantee that the NavigationFinished will be fired for any particular navigation before this event is called on the next.

Public eventNavigationStopped
Occurs when the navigation has been stopped.
Top
See Also