Frame.Navigate Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
Navigate(TypeName) |
Bewirkt, dass der Frame Inhalt lädt, der durch die angegebene Seite dargestellt wird. |
Navigate(TypeName, Object) |
Bewirkt, dass der Frame Inhalt lädt, der durch die angegebene Seite dargestellt wird, und übergibt auch einen Parameter, der vom Ziel der Navigation interpretiert werden soll. |
Navigate(TypeName, Object, NavigationTransitionInfo) |
Bewirkt, dass der Frame Inhalt lädt, der durch den angegebenen page-abgeleiteten Datentyp dargestellt wird, wobei auch ein Parameter übergeben wird, der vom Ziel der Navigation interpretiert werden soll, und einen Wert, der den zu verwendenden animierten Übergang angibt. |
Navigate(TypeName)
public:
virtual bool Navigate(TypeName sourcePageType) = Navigate;
bool Navigate(TypeName const& sourcePageType);
public bool Navigate(System.Type sourcePageType);
function navigate(sourcePageType)
Public Function Navigate (sourcePageType As Type) As Boolean
Parameter
Die Seite, zu der navigiert werden soll, die als Typverweis auf den partiellen Klassentyp angegeben ist. (Ein Typverweis wird als System.Type für Microsoft .NET oder als TypeName-Hilfsstruktur für C++ angegeben.
Gibt zurück
bool
false
, wenn ein NavigationFailed-Ereignishandlerhandled auf true
festgelegt hat, true
andernfalls . Weitere Informationen finden Sie unter Hinweise.
Implementiert
Gilt für:
Navigate(TypeName, Object)
public:
virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter) = Navigate;
/// [Windows.Foundation.Metadata.Overload("Navigate")]
bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter);
[Windows.Foundation.Metadata.Overload("Navigate")]
public bool Navigate(System.Type sourcePageType, object parameter);
function navigate(sourcePageType, parameter)
Public Function Navigate (sourcePageType As Type, parameter As Object) As Boolean
Parameter
Die Seite, zu der navigiert werden soll, die als Typverweis auf den partiellen Klassentyp angegeben ist. (Ein Typverweis wird als System.Type für Microsoft .NET oder als TypeName-Hilfsstruktur für C++ angegeben.
- parameter
-
Object
Platform::Object
IInspectable
Der Navigationsparameter, der an die Zielseite übergeben werden soll.
Gibt zurück
bool
false
, wenn ein NavigationFailed-Ereignishandlerhandled auf true
festgelegt hat, true
andernfalls . Weitere Informationen finden Sie unter Hinweise.
- Attribute
Gilt für:
Navigate(TypeName, Object, NavigationTransitionInfo)
Bewirkt, dass der Frame Inhalt lädt, der durch den angegebenen page-abgeleiteten Datentyp dargestellt wird, wobei auch ein Parameter übergeben wird, der vom Ziel der Navigation interpretiert werden soll, und einen Wert, der den zu verwendenden animierten Übergang angibt.
public:
virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter, NavigationTransitionInfo ^ infoOverride) = Navigate;
/// [Windows.Foundation.Metadata.Overload("NavigateWithTransitionInfo")]
bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter, NavigationTransitionInfo const& infoOverride);
[Windows.Foundation.Metadata.Overload("NavigateWithTransitionInfo")]
public bool Navigate(System.Type sourcePageType, object parameter, NavigationTransitionInfo infoOverride);
function navigate(sourcePageType, parameter, infoOverride)
Public Function Navigate (sourcePageType As Type, parameter As Object, infoOverride As NavigationTransitionInfo) As Boolean
Parameter
Die Seite, zu der navigiert werden soll, die als Typverweis auf den partiellen Klassentyp angegeben ist. (Ein Typverweis wird als System.Type für Microsoft .NET oder als TypeName-Hilfsstruktur für C++ angegeben.
- parameter
-
Object
Platform::Object
IInspectable
Der Navigationsparameter, der an die Zielseite übergeben werden soll; muss über einen grundlegenden Typ (string, char, numeric oder GUID) verfügen, um die Parameterserialisierung mithilfe von GetNavigationState zu unterstützen.
- infoOverride
- NavigationTransitionInfo
Informationen zum animierten Übergang.
Gibt zurück
bool
false
, wenn ein NavigationFailed-Ereignishandlerhandled auf true
festgelegt hat, true
andernfalls . Weitere Informationen finden Sie unter Hinweise.
- Attribute
Beispiele
<Frame x:Name="myFrame">
<Frame.ContentTransitions>
<TransitionCollection>
<NavigationThemeTransition />
</TransitionCollection>
</Frame.ContentTransitions>
</Frame>
// Play the default animation
myFrame.Navigate(typeof(Page2), null);
// Explicitly play the page refresh animation
myFrame.Navigate(typeof(Page2), null, new EntranceNavigationTransitionInfo());
// Play the drill in animation
myFrame.Navigate(typeof(Page2), null, new DrillInNavigationTransitionInfo());
// Suppress the default animation
myFrame.Navigate(typeof(Page2), null, new SuppressNavigationTransitionInfo());
Hinweise
Sie behandeln das NavigationFailed-Ereignis , um auf Navigationsfehler zu reagieren. Sie können den Fehler direkt im Ereignishandler behandeln, oder Sie können die NavigationFailedEventArgs.Handled-Eigenschaft auf true
festlegen und den Rückgabewert der Navigate-Methode verwenden, um auf den Fehler zu reagieren.
Parameterwerte
Sie können GetNavigationState verwenden, um den Zustand des Frames zu serialisieren, und SetNavigationState , um ihn später wiederherzustellen. Um die Framezustandsserialisierung mit diesen Methoden zu aktivieren, müssen Sie nur grundlegende Typen für die Navigation parameter
verwenden, z. B. string,char, numeric und GUID-Typen .
GetNavigationState
Andernfalls löst eine Ausnahme aus.
Der parameter
Wert kann einen komplexen Typ aufweisen, wenn Sie GetNavigationState nicht verwenden. Sie sollten jedoch weiterhin nur grundlegende Typen verwenden, um eine übermäßige Speicherauslastung zu vermeiden, die durch den Navigationsstapel des Frames verursacht wird, der einen Verweis auf den parameter
enthält. Ein bevorzugter Ansatz besteht darin, das tatsächliche Objekt nicht zu übergeben, sondern stattdessen einen Bezeichner zu übergeben, mit dem Sie das Objekt auf der Zielzielseite suchen können. Übergeben Sie beispielsweise anstelle eines Customer
-Objekts einen Verweis auf , CustomerID
und suchen Sie dann nach Customer
, nachdem die Navigation abgeschlossen ist.
Tipp
Wenn Sie mit einer Microsoft .NET-Sprache (C# oder Microsoft Visual Basic) programmieren, wird der TypeName-Typ als System.Type ausgeführt. Bei der Programmierung mit C# ist es üblich, den typeof
Operator zu verwenden, um Verweise auf den System.Type eines Typs abzurufen. Verwenden Sie GetType
in Microsoft Visual Basic . Wenn Sie C++/WinRT verwenden, können Sie die winrt::xaml_typename<T>()
Hilfsfunktion verwenden, um ein TypeName
Objekt zu erstellen. Weitere Informationen und ein Codebeispiel finden Sie in der Funktionsvorlage winrt::xaml_typename .