Export (0) Print
Expand All

NavigationService.Navigate Method (Object)

Navigate asynchronously to content that is contained by an object.

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

public bool Navigate (
	Object root
)
public boolean Navigate (
	Object root
)
public function Navigate (
	root : Object
) : boolean
You cannot use methods in XAML.

Parameters

root

An Object that contains the content to navigate to.

Return Value

A Boolean value that is set to true if a navigation is not canceled; otherwise, false.

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 a null reference (Nothing in Visual Basic), the existing content (Content) is cleared.

NoteNote:

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

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

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

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions

ADD
Show:
© 2014 Microsoft