Condividi tramite

Frame.Navigate Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml.Controls

Overload

Navigate(TypeName)

Fa in modo che frame carichi il contenuto rappresentato dalla pagina specificata.
Navigate(TypeName, Object)

Fa in modo che frame carichi il contenuto rappresentato dalla pagina specificata, passando anche un parametro da interpretare dalla destinazione dello spostamento.
Navigate(TypeName, Object, NavigationTransitionInfo)

Fa in modo che frame carichi il contenuto rappresentato dal tipo di dati derivato dalla pagina specificato, passando anche un parametro da interpretare dalla destinazione della navigazione e un valore che indica la transizione animata da usare.

Navigate(TypeName)

Modifica

Fa in modo che frame carichi il contenuto rappresentato dalla pagina specificata.

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

Parametri

sourcePageType
TypeName Type

Pagina a cui passare, specificato come riferimento di tipo al tipo di classe parziale. Un riferimento al tipo viene assegnato come System.Type per Microsoft .NET o uno struct helper TypeName per C++.

Restituisce

Boolean

bool

false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre info, vedi La sezione Osservazioni.

Implementazioni

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

Si applica a

Navigate(TypeName, Object)

Modifica

Fa in modo che frame carichi il contenuto rappresentato dalla pagina specificata, passando anche un parametro da interpretare dalla destinazione dello spostamento.

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

Parametri

sourcePageType
TypeName Type

Pagina a cui passare, specificato come riferimento di tipo al tipo di classe parziale. Un riferimento al tipo viene assegnato 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.

Restituisce

Boolean

bool

false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre info, vedi La sezione Osservazioni.

Attributi
OverloadAttribute

Si applica a

Navigate(TypeName, Object, NavigationTransitionInfo)

Modifica

Fa in modo che frame carichi il contenuto rappresentato dal tipo di dati derivato dalla pagina specificato, passando anche un parametro da interpretare dalla destinazione della navigazione e un valore che indica la transizione animata da usare.

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

Parametri

sourcePageType
TypeName Type

Pagina a cui passare, specificato come riferimento di tipo al tipo di classe parziale. Un riferimento al tipo viene assegnato 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.

Restituisce

Boolean

bool

false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre info, vedi La sezione Osservazioni.

Attributi
OverloadAttribute

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 utilizzare 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 frame usando questi metodi, è necessario usare solo i tipi di base per lo spostamento 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 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 esegue la programmazione con C#, è comune usare l'operatore typeof per ottenere riferimenti a System.Type di un tipo. In Microsoft Visual Basic usare GetType. Se usi C++/WinRT puoi usare la winrt::xaml_typename<T>() funzione helper per creare un TypeName oggetto. Per altri dettagli, vedere il modello di funzione winrt::xaml_typename e un esempio di codice.

Vedi anche

Si applica a