Frame.Navigate(TypeName, Object) method

Causes the Frame to load content represented by the specified Page-derived data type, also passing a parameter to be interpreted by the target of the navigation.

Syntax

public bool Navigate(
  Type sourcePageType, 
  object parameter
)

Parameters

sourcePageType

Type: System.Type [.NET] | TypeName [C++]

The data type of the content to load.

parameter

Type: System.Object [.NET] | Platform::Object [C++]

The object parameter to pass to the target.

Return value

Type: System.Boolean [.NET] | Platform::Boolean [C++]

true if the frame can navigate according to its settings; otherwise, false.

Remarks

To enable serialization of the frame's state using GetNavigationState, you must pass only basic types to this method, such as string, char, numeric, and GUID types. If you pass an object as a parameter, an entry in the frame's navigation stack holds a reference on the object until the frame is released or that entry is released upon a new navigation that diverges from the stack. In general, we discourage passing a non-basic type as a parameter to Navigate because it can’t be serialized when the application is suspended, and can consume more memory because a reference is held by the frame’s navigation stack to allow the application to go forward and back. 

Tip  If you are programming using a Microsoft .NET language (C# or Microsoft Visual Basic), the TypeName type projects as System.Type. When programming using C#, it is common to use the typeof operator to get references to the System.Type of a type. In Visual Basic, use GetType.

Requirements

See also

Frame

Navigate(TypeName)

Build date: 3/12/2013