Frame.Navigate Metode

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml.Controls

Overload

Navigate(TypeName)

Menyebabkan Bingkai memuat konten yang diwakili oleh tipe data turunan Halaman yang ditentukan.
Navigate(TypeName, Object)

Menyebabkan Bingkai memuat konten yang diwakili oleh jenis data turunan Halaman yang ditentukan, juga meneruskan parameter untuk ditafsirkan oleh target navigasi.
Navigate(TypeName, Object, NavigationTransitionInfo)

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

Navigate(TypeName)

Edit

Menyebabkan Bingkai memuat konten yang diwakili oleh tipe data turunan 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. Harus berupa tipe data turunan Halaman; jika tidak, pengecualian dilemparkan. (Referensi jenis diberikan sebagai System.Type untuk Microsoft .NET, atau struct pembantu TypeName untuk ekstensi komponen Visual C++ (C++/CX)).

Mengembalikan

Boolean

bool

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

Penerapan

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

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.

Aplikasi biasanya menggunakan GetNavigationState untuk membuat serialisasi status bingkai saat aplikasi ditangguhkan. Anda dapat melakukan ini langsung di kode aplikasi atau secara tidak langsung dengan menggunakan SuspensionManager kelas yang dihasilkan oleh templat Visual Studio. Untuk mengaktifkan serialisasi status bingkai menggunakan GetNavigationState, Anda hanya harus menggunakan jenis dasar untuk parameter navigasi, seperti jenis string, karakter, numerik, dan GUID . Jika tidak , GetNavigationState akan memberikan pengecualian saat aplikasi ditangguhkan. Parameter dapat memiliki jenis lain jika Anda tidak menggunakan GetNavigationState.

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 Customer objek, berikan referensi ke CustomerID, lalu cari Customer setelah navigasi selesai.

Tip

Jika Anda memprogram menggunakan bahasa Microsoft .NET (C# atau Microsoft Visual Basic), jenis TypeName diproyeksikan 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 ekstensi komponen Visual C++ (C++/CX), tempat Anda harus membuat struktur pembantu TypeName , Anda dapat menggunakan ekstensi komponen typeid.

Lihat juga

Berlaku untuk

Navigate(TypeName, Object)

Edit

Menyebabkan Bingkai memuat konten yang diwakili oleh jenis data turunan Halaman yang ditentukan, juga meneruskan parameter untuk ditafsirkan oleh target navigasi.

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

Halaman yang akan dinavigasi, ditentukan sebagai referensi jenis ke jenis kelas parsialnya. Harus berupa tipe data turunan Halaman; jika tidak, pengecualian dilemparkan. (Referensi jenis diberikan sebagai System.Type untuk Microsoft .NET, atau struct pembantu TypeName untuk ekstensi komponen Visual C++ (C++/CX)).

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.

Mengembalikan

Boolean

bool

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

Lihat juga

Berlaku untuk

Navigate(TypeName, Object, NavigationTransitionInfo)

Edit

Menyebabkan Bingkai memuat konten yang diwakili oleh jenis data turunan Halaman yang ditentukan, juga meneruskan parameter untuk 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;
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

Halaman yang akan dinavigasi, ditentukan sebagai referensi jenis ke jenis kelas parsialnya. Harus berupa tipe data turunan Halaman; jika tidak, pengecualian dilemparkan. (Referensi jenis diberikan sebagai System.Type untuk Microsoft .NET, atau struct pembantu TypeName untuk ekstensi komponen Visual C++ (C++/CX)).

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 Handled ke true; jika tidak, benar. Lihat Keterangan untuk informasi selengkapnya.

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

Lihat juga

Berlaku untuk