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 Page-dargestellt wird. |
Navigate(TypeName, Object) |
Bewirkt, dass der Frame- Inhalt lädt, der durch die angegebene Page-dargestellt wird, und übergibt außerdem 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, und übergibt außerdem einen Parameter, 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, wird als Typverweis auf den partiellen Klassentyp angegeben. (Ein Typverweis wird als System.Type- für Microsoft .NET oder eine TypeName Hilfsstruktur für C++ angegeben).
Gibt zurück
bool
false
, wenn ein NavigationFailed-Ereignishandler Handled auf true
festgelegt hat; andernfalls true
. Weitere Informationen finden Sie in den Hinweisen.
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, wird als Typverweis auf den partiellen Klassentyp angegeben. (Ein Typverweis wird als System.Type- für Microsoft .NET oder eine 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-Ereignishandler Handled auf true
festgelegt hat; andernfalls true
. Weitere Informationen finden Sie in den Hinweisen.
- Attribute
Gilt für:
Navigate(TypeName, Object, NavigationTransitionInfo)
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, wird als Typverweis auf den partiellen Klassentyp angegeben. (Ein Typverweis wird als System.Type- für Microsoft .NET oder eine TypeName Hilfsstruktur für C++ angegeben).
- parameter
-
Object
Platform::Object
IInspectable
Der Navigationsparameter, der an die Zielseite übergeben werden soll; muss über einen einfachen Typ (Zeichenfolge, Zeichen, numerische oder GUID-) verfügen, um die Parameter serialisierung mithilfe von GetNavigationState-zu unterstützen.
- infoOverride
- NavigationTransitionInfo
Informationen zum animierten Übergang.
Gibt zurück
bool
false
, wenn ein NavigationFailed-Ereignishandler Handled auf true
festgelegt hat; andernfalls true
. Weitere Informationen finden Sie in den Hinweisen.
- 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 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 Serialisierung des Framezustands mithilfe dieser Methoden zu aktivieren, müssen Sie nur grundlegende Typen für die Navigation parameter
verwenden, z. B. Zeichenfolge, Zeichen, Numerische und GUID- Typen. Andernfalls löst GetNavigationState
eine Ausnahme aus.
Der wert parameter
kann einen komplexen Typ aufweisen, wenn Sie nicht GetNavigationState-verwenden. Sie sollten jedoch immer noch nur grundlegende Typen verwenden, um eine übermäßige Speicherauslastung zu vermeiden, die durch den Navigationsstapel des Frames verursacht wird, der einen Verweis auf die parameter
enthält. Ein bevorzugter Ansatz besteht darin, das tatsächliche Objekt nicht zu übergeben, sondern einen Bezeichner zu übergeben, den Sie verwenden können, um das Objekt auf der Zielziel-Zielseite nachzuschlagen. Übergeben Sie z. B. anstelle eines Customer
-Objekts einen Verweis auf die CustomerID
, und suchen Sie dann nach Abschluss der Navigation die Customer
.
Trinkgeld
Wenn Sie eine Microsoft .NET-Sprache (C# oder Microsoft Visual Basic) programmieren, TypeName Projekte als System.Typeeingeben. Bei der Programmierung mit C# wird häufig der typeof
-Operator verwendet, um Verweise auf die System.Type- eines Typs abzurufen. Verwenden Sie in Microsoft Visual Basic GetType
. 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 unter winrt::xaml_typename Funktionsvorlage.