NavigationService.Navigate Method (Uri)

 

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

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

Public Function Navigate (
	source As Uri
) As Boolean

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.

Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text))
End Sub

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