Frame.Navigate Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| Navigate(TypeName) |
Fa sì che il frame di |
| Navigate(TypeName, Object) |
Fa sì che il frame di |
| Navigate(TypeName, Object, NavigationTransitionInfo) |
Fa sì che il frame di |
Navigate(TypeName)
Fa sì che il frame di
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 BooleanParametri
Pagina a cui passare, specificato come riferimento di tipo al tipo di classe parziale. Un riferimento al tipo viene fornito come System.Type per Microsoft .NET o uno struct helper TypeName per C++.
Valori restituiti
bool
false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre info, vedi La sezione Osservazioni.
Implementazioni
Si applica a
Navigate(TypeName, Object)
Fa sì che il frame di
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 BooleanParametri
Pagina a cui passare, specificato come riferimento di tipo al tipo di classe parziale. Un riferimento al tipo viene fornito come System.Type per Microsoft .NET o uno struct helper TypeName per C++.
- parameter
-
Object
Platform::Object
IInspectable
Parametro di navigazione da passare alla pagina di destinazione.
Valori restituiti
bool
false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre info, vedi La sezione Osservazioni.
- Attributi
Si applica a
Navigate(TypeName, Object, NavigationTransitionInfo)
Fa sì che il frame di
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 BooleanParametri
Pagina a cui passare, specificato come riferimento di tipo al tipo di classe parziale. Un riferimento al tipo viene fornito come System.Type per Microsoft .NET o uno struct helper TypeName per C++.
- parameter
-
Object
Platform::Object
IInspectable
Parametro di navigazione da passare alla pagina di destinazione; deve avere un tipo di base (string, char, numeric o GUID) per supportare la serializzazione dei parametri tramite GetNavigationState.
- infoOverride
- NavigationTransitionInfo
Informazioni sulla transizione animata.
Valori restituiti
bool
false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre info, vedi La sezione Osservazioni.
- Attributi
Esempio
<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());
Commenti
L'evento NavigationFailed viene gestito per rispondere all'errore di spostamento. È possibile gestire l'errore direttamente nel gestore eventi oppure impostare la proprietà NavigationFailedEventArgs.Handled su true e usare il valore restituito del metodo Navigate per rispondere all'errore.
Valori dei parametri
È possibile usare GetNavigationState per serializzare lo stato del frame e SetNavigationState per ripristinarlo in un secondo momento. Per abilitare la serializzazione dello stato dei fotogrammi usando questi metodi, è necessario usare solo i tipi di base per la navigazione parameter, ad esempio i tipi string, char, numeric e GUID . In caso contrario, GetNavigationState genererà un'eccezione.
Il parameter valore può avere un tipo complesso se non si usa GetNavigationState. Tuttavia, è comunque consigliabile usare solo i tipi di base per evitare l'utilizzo eccessivo della memoria causato dallo stack di navigazione del frame che contiene un riferimento a parameter. Un approccio preferito consiste nel non passare l'oggetto effettivo, ma passare invece un identificatore che è possibile usare per cercare l'oggetto nella pagina di destinazione. Ad esempio, invece di passare un Customer oggetto , passare un riferimento a CustomerID, quindi cercare Customer dopo il completamento della navigazione.
Tip
Se si esegue la programmazione usando un linguaggio di Microsoft .NET (C#), il tipo TypeName proietta come System.Type. Quando si esegue la programmazione con C#, è comune usare l'operatore typeof per ottenere riferimenti a System.Type di un tipo.
Se usi C++/WinRT puoi usare la winrt::xaml_typename<T>() funzione helper per creare un TypeName oggetto. Per altri dettagli, vedere modello di funzione winrt::xaml_typename e un esempio di codice.