Frame.Navigate Methode

Definition

Namespace:

Windows.UI.Xaml.Controls

Überlädt

Navigate(TypeName)	Bewirkt, dass der Frame Inhalt lädt, der durch den angegebenen page-abgeleiteten Datentyp dargestellt wird.
Navigate(TypeName, Object)	Bewirkt, dass der Frame Inhalt lädt, der durch den angegebenen page-abgeleiteten Datentyp 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)

Bewirkt, dass der Frame Inhalt lädt, der durch den angegebenen page-abgeleiteten Datentyp 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. Muss ein von Page abgeleiteter Datentyp sein. Andernfalls wird eine Ausnahme ausgelöst. (Ein Typverweis wird als System.Type für Microsoft .NET oder als TypeName-Hilfsstruktur für Visual C++-Komponentenerweiterungen (C++/CX) angegeben.

Gibt zurück

Boolean

bool

false , wenn ein NavigationFailed-EreignishandlerHandled auf true festgelegt hat; andernfalls true. Weitere Informationen finden Sie unter Hinweise.

Implementiert

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

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.

Apps verwenden in der Regel GetNavigationState , um den Framezustand zu serialisieren, wenn die App angehalten wird. Sie können dies direkt in Ihrem App-Code oder indirekt mithilfe der klasse tun, die SuspensionManager von den Visual Studio-Vorlagen generiert wurde. Um die Serialisierung des Framezustands mithilfe von GetNavigationState zu aktivieren, müssen Sie nur grundlegende Typen für den Navigationsparameter verwenden, z. B. string-, char-, numeric- und GUID-Typen . Andernfalls löst GetNavigationState eine Ausnahme aus, wenn die App angehalten wird. Der Parameter kann andere Typen aufweisen, wenn Sie GetNavigationState nicht verwenden.

Der Parameterwert kann einen komplexen Typ aufweisen, wenn Sie GetNavigationState nicht verwenden. Sie sollten jedoch weiterhin nur grundlegende Typen verwenden, um eine übermäßige Arbeitsspeicherauslastung 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 , 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 in Microsoft Visual Basic GetType. Wenn Sie Visual C++-Komponentenerweiterungen (C++/CX) verwenden, wo Sie eine TypeName-Hilfsstruktur erstellen müssen, können Sie die Typeid-Komponentenerweiterung verwenden.

Weitere Informationen

• Page
• Navigate(TypeName, Object)
• NavigationFailed
• Navigation

Navigate(TypeName, Object)

Bewirkt, dass der Frame Inhalt lädt, der durch den angegebenen page-abgeleiteten Datentyp 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;

bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter);

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. Muss ein von Page abgeleiteter Datentyp sein. Andernfalls wird eine Ausnahme ausgelöst. (Ein Typverweis wird als System.Type für Microsoft .NET oder als TypeName-Hilfsstruktur für Visual C++-Komponentenerweiterungen (C++/CX) 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.

Gibt zurück

Boolean

bool

false , wenn ein NavigationFailed-EreignishandlerHandled auf true festgelegt hat; andernfalls true. Weitere Informationen finden Sie unter Hinweise.

Weitere Informationen

• Page
• Navigate(TypeName)
• Navigation

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;

bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter, NavigationTransitionInfo const& infoOverride);

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. Muss ein von Page abgeleiteter Datentyp sein. Andernfalls wird eine Ausnahme ausgelöst. (Ein Typverweis wird als System.Type für Microsoft .NET oder als TypeName-Hilfsstruktur für Visual C++-Komponentenerweiterungen (C++/CX) 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 true festgelegt hat; andernfalls true. Weitere Informationen finden Sie unter Hinweise.

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());

Weitere Informationen

• Navigate(TypeName, Object)
• Navigate(TypeName)
• Navigation