Frame.Navigate Methode

Definition

Namespace:: Microsoft.UI.Xaml.Controls

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

Name	Beschreibung
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)

Bearbeiten

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 als TypeName-Hilfsstruktur für C++ angegeben).

Gibt zurück

Boolean

bool

false if a NavigationFailed event handler has set Handled to true; otherwise, 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)

Bearbeiten

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

parameter: Object
Platform::Object

IInspectable

Der Navigationsparameter, der an die Zielseite übergeben werden soll.

Gibt zurück

Boolean

bool

false if a NavigationFailed event handler has set Handled to true; otherwise, true. Weitere Informationen finden Sie in den Hinweisen.

Attribute: OverloadAttribute

Gilt für:

Navigate(TypeName, Object, NavigationTransitionInfo)

Bearbeiten

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

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 Serialisierung von Parametern mithilfe von GetNavigationState zu unterstützen.

infoOverride: NavigationTransitionInfo

Informationen zum animierten Übergang.

Gibt zurück

Boolean

bool

false if a NavigationFailed event handler has set Handled to true; otherwise, true. Weitere Informationen finden Sie in den Hinweisen.

Attribute: OverloadAttribute

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 den Rückgabewert der Navigate-Methode festlegen, 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. Zeichenfolgen-, Zeichen-, numerische und GUID-Typen . GetNavigationState Andernfalls wird eine Ausnahme ausgelöst.

Der parameter Wert kann einen komplexen Typ aufweisen, wenn Sie "GetNavigationState" nicht 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. 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 den CustomerID, und suchen Sie nach, Customer nachdem die Navigation abgeschlossen ist.

Tip

Wenn Sie eine Microsoft .NET Sprache (C#) programmieren, wird der TypeName-Typ als "System.Type" projiziert. Bei der Programmierung mit C# wird häufig der typeof Operator verwendet, um Verweise auf den System.Type eines Typs abzurufen.

Wenn Sie C++/WinRT verwenden, können Sie mithilfe der winrt::xaml_typename<T>() Hilfsfunktion ein TypeName Objekt erstellen. Weitere Informationen und ein Codebeispiel finden Sie unter winrt::xaml_typename Funktionsvorlage .

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?