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
| Navigate(TypeName) |
Causa il caricamento del contenuto di Frame rappresentato dal tipo di dati derivato dalla pagina specificata. |
| Navigate(TypeName, Object) |
Causa il caricamento del contenuto rappresentato dal tipo di dati derivato dalla pagina specificata, passando anche un parametro da interpretare dalla destinazione della navigazione. |
| Navigate(TypeName, Object, NavigationTransitionInfo) |
Causa il caricamento del contenuto rappresentato dal tipo di dati derivato dalla pagina specificato, passando anche un parametro da interpretare dalla destinazione dello spostamento e un valore che indica la transizione animata da usare. |
Navigate(TypeName)
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 da passare a, specificata come riferimento al tipo di classe parziale. Deve essere un tipo di dati derivato da pagina; in caso contrario, viene generata un'eccezione. Un riferimento al tipo viene assegnato come System.Type per Microsoft .NET o uno struct helper TypeName per le estensioni dei componenti di Visual C++ (C++/CX).
Restituisce
bool
false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre informazioni, vedere Osservazioni.
Implementazioni
Commenti
Si gestisce l'evento NavigationFailed 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.
Le app in genere usano GetNavigationState per serializzare lo stato del frame quando l'app sospende. È possibile eseguire questa operazione direttamente nel codice dell'app o indirettamente usando la SuspensionManager classe generata dai modelli di Visual Studio. Per abilitare la serializzazione dello stato del frame usando GetNavigationState, è necessario usare solo tipi di base per il parametro di spostamento, ad esempio string, char, numeric e GUID . In caso contrario , GetNavigationState genererà un'eccezione quando l'app sospende. Il parametro può avere altri tipi se non si usa GetNavigationState.
Il valore del parametro può avere un tipo complesso se non si usa GetNavigationState. Tuttavia, è consigliabile usare solo i tipi di base per evitare l'utilizzo di memoria in eccesso causato dallo stack di spostamento del frame che contiene un riferimento al parametro. 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 oggetto, passare un Customer riferimento a CustomerID, quindi cercare dopo Customer il completamento della navigazione.
Suggerimento
Se si esegue la programmazione usando un linguaggio Microsoft .NET (C# o Microsoft Visual Basic), i progetti di tipo TypeName come System.Type. Quando si usa C#, è comune usare l'operatore typeof per ottenere riferimenti al tipo System.Type di un tipo. In Microsoft Visual Basic usare GetType. Se si usano estensioni del componente Visual C++ (C++/CX), dove è necessario creare uno struct helper TypeName , è possibile usare l'estensione del componente typeid.
Vedi anche
Si applica a
Navigate(TypeName, Object)
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 BooleanParametri
Pagina da passare a, specificata come riferimento al tipo di classe parziale. Deve essere un tipo di dati derivato da pagina; in caso contrario, viene generata un'eccezione. Un riferimento al tipo viene assegnato come System.Type per Microsoft .NET o uno struct helper TypeName per le estensioni dei componenti di Visual C++ (C++/CX).
- parameter
-
Object
Platform::Object
IInspectable
Parametro di spostamento da passare alla pagina di destinazione; deve avere un tipo di base (string, char, numeric o GUID) per supportare la serializzazione dei parametri usando GetNavigationState.
Restituisce
bool
false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre informazioni, vedere Osservazioni.
Vedi anche
Si applica a
Navigate(TypeName, Object, NavigationTransitionInfo)
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 BooleanParametri
Pagina da passare a, specificata come riferimento al tipo di classe parziale. Deve essere un tipo di dati derivato da pagina; in caso contrario, viene generata un'eccezione. Un riferimento al tipo viene assegnato come System.Type per Microsoft .NET o uno struct helper TypeName per le estensioni dei componenti di Visual C++ (C++/CX).
- parameter
-
Object
Platform::Object
IInspectable
Parametro di spostamento da passare alla pagina di destinazione; deve avere un tipo di base (string, char, numeric o GUID) per supportare la serializzazione dei parametri usando GetNavigationState.
- infoOverride
- NavigationTransitionInfo
Informazioni sulla transizione animata.
Restituisce
bool
false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre informazioni, vedere Osservazioni.
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());