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 oleh Halaman yang ditentukan, juga meneruskan parameter yang ditafsirkan oleh target navigasi.
Navigate(TypeName, Object, NavigationTransitionInfo)

Menyebabkan Bingkai memuat konten yang diwakili oleh jenis data turunan Halaman yang ditentukan, juga meneruskan parameter yang 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 pembantu TypeName untuk C++).

Mengembalikan

Boolean

bool

false jika handler acara NavigationFailed telah mengatur Handled 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 oleh Halaman yang ditentukan, juga meneruskan parameter yang 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 pembantu TypeName untuk C++).

parameter
Object

Platform::Object

IInspectable

Parameter navigasi untuk diteruskan ke halaman target.

Mengembalikan

Boolean

bool

false jika handler acara NavigationFailed telah mengatur Handled 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 data turunan Halaman yang ditentukan, juga meneruskan parameter yang 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 pembantu TypeName 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 handler acara NavigationFailed telah mengatur Handled 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 true 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 hanya harus menggunakan jenis dasar untuk navigasi parameter, seperti jenis string, karakter, numerik, dan GUID . Jika tidak, GetNavigationState akan melemparkan pengecualian.

Nilai parameter dapat memiliki jenis kompleks jika Anda tidak menggunakan GetNavigationState. Namun, Anda masih harus menggunakan hanya 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, teruskan Customer referensi ke CustomerID, lalu cari Customer setelah navigasi selesai.

Tip

Jika Anda memprogram menggunakan bahasa Microsoft .NET (C# atau Microsoft Visual Basic), jenis TypeName memproyeksikan sebagai System.Type. Saat pemrograman menggunakan C#, biasanya menggunakan typeof operator 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 TypeName objek. Lihat templat fungsi winrt::xaml_typename untuk detail selengkapnya, dan contoh kode.

Lihat juga

Berlaku untuk