Freigeben über

Frame.Navigate Methode

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Controls

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

Bearbeiten

Bewirkt, dass der Frame Inhalt lädt, der durch die angegebene Seite 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, 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

Boolean

bool

false , wenn ein NavigationFailed-Ereignishandlerhandled auf truefestgelegt hat, trueandernfalls . Weitere Informationen finden Sie unter Hinweise.

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 Seite dargestellt wird, und übergibt auch 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, 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

Boolean

bool

false , wenn ein NavigationFailed-Ereignishandlerhandled auf truefestgelegt hat, trueandernfalls . Weitere Informationen finden Sie unter Hinweise.

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, 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

sourcePageType
TypeName Type

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

Boolean

bool

false , wenn ein NavigationFailed-Ereignishandlerhandled auf truefestgelegt hat, trueandernfalls . Weitere Informationen finden Sie unter Hinweise.

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 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 parameterverwenden, 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 parameterenthä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 , CustomerIDund 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 GetTypein 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 .

Weitere Informationen

Gilt für: