Bagikan melalui

Frame.Navigate Metode

  • Referensi

Definisi

Ruang nama:
Microsoft.UI.Xaml.Controls

Overload

Navigate(TypeName)

Menyebabkan Bingkai memuat konten yang diwakili oleh halaman yang ditentukan.
Navigate(TypeName, Object)

Menyebabkan Bingkai memuat konten yang diwakili olehHalaman yang ditentukan , juga meneruskan parameter yang akan ditafsirkan oleh target navigasi.
Navigate(TypeName, Object, NavigationTransitionInfo)

Menyebabkan Bingkai memuat konten yang diwakili oleh jenis dataHalaman yang ditentukan, juga meneruskan parameter yang akan ditafsirkan oleh target navigasi, dan nilai yang menunjukkan transisi animasi yang akan digunakan.

Navigate(TypeName)

Edit

Menyebabkan Bingkai memuat konten yang diwakili oleh halaman yang ditentukan.

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

Halaman yang akan dinavigasi, ditentukan sebagai referensi jenis ke jenis kelas parsialnya. (Referensi jenis diberikan sebagai System.Type untuk Microsoft .NET, atau struct TypeName helper untuk C++).

Mengembalikan

Boolean

bool

false jika penanganan aktivitas NavigationFailed telah mengatur Ditangani ke true; jika tidak, true. Lihat Keterangan untuk informasi selengkapnya.

Penerapan

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

Berlaku untuk

Navigate(TypeName, Object)

Edit

Menyebabkan Bingkai memuat konten yang diwakili olehHalaman yang ditentukan , juga meneruskan parameter yang akan ditafsirkan oleh target navigasi.

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

Halaman yang akan dinavigasi, ditentukan sebagai referensi jenis ke jenis kelas parsialnya. (Referensi jenis diberikan sebagai System.Type untuk Microsoft .NET, atau struct TypeName helper untuk C++).

parameter
Object

Platform::Object

IInspectable

Parameter navigasi untuk diteruskan ke halaman target.

Mengembalikan

Boolean

bool

false jika penanganan aktivitas NavigationFailed telah mengatur Ditangani ke true; jika tidak, true. Lihat Keterangan untuk informasi selengkapnya.

Atribut
OverloadAttribute

Berlaku untuk

Navigate(TypeName, Object, NavigationTransitionInfo)

Edit

Menyebabkan Bingkai memuat konten yang diwakili oleh jenis dataHalaman yang ditentukan, juga meneruskan parameter yang akan ditafsirkan oleh target navigasi, dan nilai yang menunjukkan transisi animasi yang akan digunakan.

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

Halaman yang akan dinavigasi, ditentukan sebagai referensi jenis ke jenis kelas parsialnya. (Referensi jenis diberikan sebagai System.Type untuk Microsoft .NET, atau struct TypeName helper untuk C++).

parameter
Object

Platform::Object

IInspectable

Parameter navigasi untuk diteruskan ke halaman target; harus memiliki jenis dasar (string, karakter, numerik, atau GUID) untuk mendukung serialisasi parameter menggunakan GetNavigationState.

infoOverride
NavigationTransitionInfo

Info tentang transisi animasi.

Mengembalikan

Boolean

bool

false jika penanganan aktivitas NavigationFailed telah mengatur Ditangani ke true; jika tidak, true. Lihat Keterangan untuk informasi selengkapnya.

Atribut
OverloadAttribute

Contoh

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

Keterangan

Anda menangani peristiwa NavigationFailed untuk merespons kegagalan navigasi. Anda dapat menangani kegagalan secara langsung di penanganan aktivitas, atau Anda dapat mengatur properti NavigationFailedEventArgs.Handled ke dan menggunakan nilai pengembalian metode Navigasi untuk merespons kegagalan.

Nilai parameter

Anda dapat menggunakan GetNavigationState untuk menserialisasikan status bingkai, dan SetNavigationState untuk memulihkannya nanti. Untuk mengaktifkan serialisasi status bingkai menggunakan metode ini, Anda harus hanya menggunakan jenis dasar untuk parameternavigasi , seperti jenis string, karakter, numerik, dan GUID. Jika tidak, GetNavigationState akan memberikan pengecualian.

Nilai parameter dapat memiliki jenis kompleks jika Anda tidak menggunakan GetNavigationState. Namun, Anda masih harus hanya menggunakan jenis dasar untuk menghindari penggunaan memori berlebih yang disebabkan oleh tumpukan navigasi bingkai yang menyimpan referensi ke parameter. Pendekatan yang disukai adalah tidak meneruskan objek aktual, tetapi sebaliknya meneruskan pengidentifikasi yang dapat Anda gunakan untuk mencari objek di halaman arahan target. Misalnya, alih-alih meneruskan objek Customer, teruskan referensi ke CustomerID, lalu cari Customer setelah navigasi selesai.

Ujung

Jika Anda memprogram menggunakan bahasa Microsoft .NET (C# atau Microsoft Visual Basic), TypeName mengetik proyek sebagai System.Type. Saat pemrograman menggunakan C#, adalah umum untuk menggunakan operator typeof untuk mendapatkan referensi ke System.Type jenis. Di Microsoft Visual Basic, gunakan GetType. Jika Anda menggunakan C++/WinRT Anda dapat menggunakan fungsi pembantu winrt::xaml_typename<T>() untuk membuat objek TypeName. Lihat templat fungsi winrt::xaml_typename untuk detail selengkapnya, dan contoh kode.

Lihat juga

Berlaku untuk