Frame.Navigate Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

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)

Causa il caricamento del contenuto di Frame rappresentato dal tipo di dati derivato 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 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

Boolean

bool

false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre informazioni, vedere Osservazioni.

Implementazioni

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

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

• Page
• Navigate(TypeName, Object)
• NavigationFailed
• Spostamento

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.

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

Parametri

sourcePageType

TypeName Type

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

Boolean

bool

false se un gestore eventi NavigationFailed ha impostato Handled su true; in caso contrario, true. Per altre informazioni, vedere Osservazioni.

Vedi anche

• Page
• Navigate(TypeName)
• Spostamento

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.

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

Parametri

sourcePageType

TypeName Type

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

Boolean

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

Vedi anche

• Navigate(TypeName, Object)
• Navigate(TypeName)
• Spostamento