Frame.Navigate(TypeName, Object) Method

Bewirkt, dass der Frame Inhalt lädt, der durch den Page-abgeleiteten Datentyp dargestellt wird. Außerdem wird ein Parameter übergeben, der vom Navigationsziel interpretiert werden muss.

Syntax


public bool Navigate(
  Type sourcePageType, 
  object parameter
)

Parameter

sourcePageType

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

Der Datentyp des zu ladenden Inhalts.

parameter

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

Der an die Zielseite zu übergebende Navigationsparameter muss über einen einfachen Typ (Zeichenfolge, char, numerisch oder GUID) verfügen, um die Parameterserialisierung mithilfe von GetNavigationState zu unterstützen.

Rückgabewert

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

false, wenn für einen NavigationFailed-Ereignishandler die Handled-Eigenschaft auf true festgelegt wurde. Andernfalls gilt true. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Derzeit müssen Sie das NavigationFailed-Ereignis behandeln, damit auf Navigationsfehler reagiert wird. Sie können den Fehler direkt im Ereignishandler behandeln, oder Sie können die NavigationFailedEventArgs.Handled-Eigenschaft auf true festlegen und den Navigate-Methodenrückgabewert verwenden, um auf den Fehler zu reagieren.

Apps verwenden in der Regel GetNavigationState, um den Zustand der Frames zu serialisieren, wenn die App angehalten wird. Sie können dies direkt im App-Code oder indirekt mit der SuspensionManager-Klasse ausführen, die durch die Visual Studio-App-Vorlagen generiert wird. Um die Serialisierung des Rahmenzustands mithilfe der GetNavigationState-Methode zu aktivieren, dürfen Sie nur grundlegende Typen für den Navigationsparameter verwenden, wie Zeichenfolge-, Zeichen-, numerische und GUID-Typen. Andernfalls löst GetNavigationState eine Ausnahme aus, wenn die App angehalten wird. Der Parameter kann über andere Typen verfügen, wenn Sie GetNavigationState nicht verwenden.

Der Parameterwert kann einen komplexen Typ haben, wenn Sie GetNavigationState nicht verwenden. Sie sollten jedoch nach wie vor nur grundlegende Typen verwenden, um eine zu starke Speicherauslastung zu vermeiden, die dadurch verursacht wird, dass der Navigationsstapel des Frames einen Verweis auf den Parameter enthält.

Tipp  Wenn Sie mit einer Microsoft. NET-Sprache (C# oder Microsoft Visual Basic) programmieren, wird der TypeName-Typ als System.Type abgebildet. Beim Programmieren in C# wird häufig der typeof-Operator verwendet, um Verweise auf die System.Type-Klasse eines Typs abzurufen. Verwenden Sie GetType in Visual Basic.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadaten

Windows.winmd

Siehe auch

Frame
Navigate(TypeName)

 

 

Anzeigen:
© 2014 Microsoft