Frame.Navigate 方法

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Controls

多載

Navigate(TypeName)

導致 Frame 載入指定 之 Page 所代表的內容。
Navigate(TypeName, Object)

導致 Frame 載入指定 之 Page 所代表的內容，也會傳遞由導覽目標解譯的參數。
Navigate(TypeName, Object, NavigationTransitionInfo)

導致 Frame 載入由指定 頁面衍生數據類型所代表的內容，也會傳遞由導覽目標解譯的參數，以及指出要使用的動畫轉換值。

Navigate(TypeName)

編輯

導致 Frame 載入指定 之 Page 所代表的內容。

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

參數

sourcePageType
TypeName Type

要巡覽的頁面，指定為其部分類別類型的型別參考。 (類型參考會指定為 System.Type for Microsoft .NET，或 C++) 的 TypeName 協助程序結構。

傳回

Boolean

bool

false 如果 NavigationFailed 事件處理程式已將 Handled 設定為 true，則為 ，否則為 true。 如需詳細資訊，請參閱。

實作

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

適用於

Navigate(TypeName, Object)

編輯

導致 Frame 載入指定 之 Page 所代表的內容，也會傳遞由導覽目標解譯的參數。

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

參數

sourcePageType
TypeName Type

要巡覽的頁面，指定為其部分類別類型的型別參考。 (類型參考會指定為 System.Type for Microsoft .NET，或 C++) 的 TypeName 協助程序結構。

parameter
Object

Platform::Object

IInspectable

要傳遞至目標頁面的導覽參數。

傳回

Boolean

bool

false 如果 NavigationFailed 事件處理程式已將 Handled 設定為 true，則為 ，否則為 true。 如需詳細資訊，請參閱。

屬性
OverloadAttribute

適用於

Navigate(TypeName, Object, NavigationTransitionInfo)

編輯

導致 Frame 載入由指定 頁面衍生數據類型所代表的內容，也會傳遞由導覽目標解譯的參數，以及指出要使用的動畫轉換值。

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

參數

sourcePageType
TypeName Type

要巡覽的頁面，指定為其部分類別類型的型別參考。 (類型參考會指定為 System.Type for Microsoft .NET，或 C++) 的 TypeName 協助程序結構。

parameter
Object

Platform::Object

IInspectable

要傳遞至目標頁面的導覽參數;必須具有基本類型 (字串、char、numeric 或 GUID) ，才能使用 GetNavigationState 支持參數串行化。

infoOverride
NavigationTransitionInfo

動畫轉換的相關信息。

傳回

Boolean

bool

false 如果 NavigationFailed 事件處理程式已將 Handled 設定為 true，則為 ，否則為 true。 如需詳細資訊，請參閱。

屬性
OverloadAttribute

範例

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

備註

您可以處理 NavigationFailed 事件來響應瀏覽失敗。 您可以直接在事件處理程式中處理失敗，也可以將 NavigationFailedEventArgs.Handled 屬性設定為 true ，並使用 Navigate 方法傳回值來回應失敗。

參數值

您可以使用 GetNavigationState 來串行化框架的狀態，而 SetNavigationState 稍後再還原它。 若要使用這些方法來啟用畫面狀態串行化，您必須只針對導覽 parameter使用基本類型，例如字串、char、numeric 和 GUID 類型。 否則， GetNavigationState 將會擲回例外狀況。

如果您沒有使用 GetNavigationState，此值parameter可以有複雜類型。 不過，您仍應該只使用基本類型，以避免框架導覽堆疊保存 參考 parameter所造成的記憶體使用量過多。 慣用的方法是不要傳遞實際物件，而是傳遞標識符，讓您可用來在目標登陸頁面中查閱物件。 例如，不要傳遞 Customer 物件，而是傳遞 的 CustomerID參考，然後在流覽完成之後查閱 Customer 。

提示

如果您是使用 Microsoft .NET 語言進行程式設計， (C# 或 Microsoft Visual Basic ) ，TypeName 類型會專案為 System.Type。 使用 C# 進行程式設計時，通常會使用 typeof 運算符來取得型別 System.Type 的參考。 在 Microsoft Visual Basic 中，使用 GetType。 如果您使用 C++/WinRT ，您可以使用 winrt::xaml_typename<T>() 協助程式函式來建立 TypeName 物件。 如需詳細資訊，請參閱 winrt：：xaml_typename函式範例 。

另請參閱

適用於