Freigeben über


Frame.Navigate Methode

Definition

Ü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)

Bewirkt, dass der Frame- Inhalt lädt, der durch die angegebene Page-dargestellt wird.

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

sourcePageType
TypeName Type

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

Boolean

bool

false, wenn ein NavigationFailed-Ereignishandler Handled auf truefestgelegt hat; andernfalls true. Weitere Informationen finden Sie in den Hinweisen.

Implementiert

M:Microsoft.UI.Xaml.Controls.INavigate.Navigate(Windows.UI.Xaml.Interop.TypeName) M:Microsoft.UI.Xaml.Controls.INavigate.Navigate(System.Type)

Gilt für:

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.

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

sourcePageType
TypeName Type

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

Boolean

bool

false, wenn ein NavigationFailed-Ereignishandler Handled auf truefestgelegt hat; andernfalls true. Weitere Informationen finden Sie in den Hinweisen.

Attribute

Gilt für:

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.

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

sourcePageType
TypeName Type

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

Boolean

bool

false, wenn ein NavigationFailed-Ereignishandler Handled auf truefestgelegt 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 parameterverwenden, 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 parameterenthä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.

Weitere Informationen

Gilt für: