WebView.NavigationStarting Event

Definition

Namespace:

Windows.UI.Xaml.Controls

Occurs before the WebView navigates to new content.

// Register
event_token NavigationStarting(TypedEventHandler<WebView, WebViewNavigationStartingEventArgs const&> const& handler) const;

// Revoke with event_token
void NavigationStarting(event_token const* cookie) const;

// Revoke with event_revoker
WebView::NavigationStarting_revoker NavigationStarting(auto_revoke_t, TypedEventHandler<WebView, WebViewNavigationStartingEventArgs const&> const& handler) const;

public event TypedEventHandler<WebView,WebViewNavigationStartingEventArgs> NavigationStarting;

function onNavigationStarting(eventArgs) { /* Your code */ }
webView.addEventListener("navigationstarting", onNavigationStarting);
webView.removeEventListener("navigationstarting", onNavigationStarting);
- or -
webView.onnavigationstarting = onNavigationStarting;

Public Custom Event NavigationStarting As TypedEventHandler(Of WebView, WebViewNavigationStartingEventArgs) 

<WebView NavigationStarting="eventhandler" />

Event Type

TypedEventHandler<WebView,WebViewNavigationStartingEventArgs>

Examples

The following code example demonstrates how to handle this event to update a text box used as an address bar. For the complete example, see the XAML WebView control sample.

void webViewA_NavigationStarting(WebView sender, WebViewNavigationStartingEventArgs args)
{
    string url = "";
    try { url = args.Uri.ToString(); }
    finally
    {
        address.Text = url;
        appendLog(String.Format("Starting navigation to: \"{0}\".\n", url));
        pageIsLoading = true;
    }
}

Remarks

You can cancel navigation in a handler for this event by setting the WebViewNavigationStartingEventArgs.Cancel property to true.

WebView navigation events occur in the following order:

• NavigationStarting
• ContentLoading
• DOMContentLoaded
• NavigationCompleted

Similar events occur in the same order for each iframe in the WebView content:

• FrameNavigationStarting
• FrameContentLoading
• FrameDOMContentLoaded
• FrameNavigationCompleted

See also

• WebViewNavigationStartingEventArgs
• XAML WebView control sample