NavigationService.Navigate Method (Object) (System.Windows.Navigation)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

.NET Framework Class Library

NavigationService.Navigate Method (Object)

Navigate asynchronously to content that is contained by an object.

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

Syntax

Visual Basic

Public Function Navigate ( _
	root As Object _
) As Boolean

public bool Navigate(
	Object root
)

Visual C++

public:
bool Navigate(
	Object^ root
)

member Navigate : 
        root:Object -> bool

Parameters

root: Type: System.Object
An object that contains the content to navigate to.

Return Value

Type: System.Boolean
true if a navigation is not canceled; otherwise, false.

Remarks

Navigate will navigate to the Object specified by root if the following conditions are true:

The Navigating event is not cancelled.
A web request (see Navigating) can be created.

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

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

Examples

The following example shows how to navigate to a Page object containing the source content tree.

Visual Basic


Private Sub goObjectButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New ContentPage())
End Sub


void goObjectButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new ContentPage());
}

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

NavigationService Class

Navigate Overload

System.Windows.Navigation Namespace

NavigationService.Navigate