Export (0) Print
Expand All

WebBrowser.Navigate Method (Uri)

Navigate asynchronously to the document at the specified Uri.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

public void Navigate(
	Uri source
)

Parameters

source
Type: System.Uri

The Uri to navigate to.

ExceptionCondition
ObjectDisposedException

The WebBrowser instance is no longer valid.

InvalidOperationException

A reference to the underlying native WebBrowser could not be retrieved.

SecurityException

Navigation from an application that is running in partial trust to a Uri that is not located at the site of origin.

Calling Navigate(Uri) has the same effect as setting the Source property. Source is used from markup by developers who want to declaratively specify the initial document that WebBrowser navigates to when WebBrowser is initialized.

Use the Navigate(String) method to navigate to a URL that may include escape characters. Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

The following example shows how to use WebBrowser to navigate to a document by using the Navigate(Uri) method.

    <StackPanel>
        <StackPanel Orientation="Horizontal">
            <TextBox x:Name="addressTextBox" Width="200" />
            <Button Click="goNavigateButton_Click">Go</Button>
        </StackPanel>
        <WebBrowser x:Name="myWebBrowser" />
    </StackPanel>
        private void goNavigateButton_Click(object sender, RoutedEventArgs e)
        {
            // Get URI to navigate to
            Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);

            // Only absolute URIs can be navigated to
            if (!uri.IsAbsoluteUri)
            {
                MessageBox.Show("The Address URI must be absolute eg 'http://www.microsoft.com'");
                return;
            }

            // Navigate to the desired URL by calling the .Navigate method
            this.myWebBrowser.Navigate(uri);
        }

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1, 3.0 SP2

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft