NavigationService.Navigate Method (Uri)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Navigate asynchronously to content that is specified by a uniform resource identifier (URI).

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

public bool Navigate(
	Uri source
)

Parameters

source
Type: System.Uri

A Uri object initialized with the URI for the desired content.

Return Value

Type: System.Boolean

true if a navigation is not canceled; otherwise, false.

The value of source can be a Web URL or a valid pack URI (see Pack URIs in WPF).

Navigate will navigate to the URI specified by source if the following conditions are true:

If source is null, the existing content (Content) is cleared.

System_CAPS_noteNote

When downloading Web content, you may receive a Web exception (for example, 404: File Not Found). You can handle such exceptions from NavigationFailed.

You can use Navigate to navigate to a content fragment. If the content identified by the URI is the current content, it is not downloaded again.

The following example shows how to navigate to a URI.

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new Uri(this.addressTextBox.Text));
}

.NET Framework
Available since 3.0
Silverlight
Available since 3.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: