NavigatingCancelEventArgs Classe

Definizione

Spazio dei nomi:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Fornisce i dati per l'evento Navigating .

public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs

public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs

type NavigatingCancelEventArgs = class
    inherit CancelEventArgs

Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

Ereditarietà

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Esempio

Nell'esempio seguente viene illustrato come gestire Navigating per rilevare se è stata effettuata una richiesta di aggiornamento del contenuto statico e, in caso affermativo, come annullare la richiesta.

Navigating.

void NavigationService_Navigating(object sender, NavigatingCancelEventArgs e)
{
    // Don't allow refreshing of a static page
    if ((e.NavigationMode == NavigationMode.Refresh) &&
        (e.Uri.OriginalString == "StaticPage.xaml"))
    {
        e.Cancel = true;
    }
}

Private Sub NavigationService_Navigating(ByVal sender As Object, ByVal e As NavigatingCancelEventArgs)
    ' Don't allow refreshing of a static page
    If (e.NavigationMode = NavigationMode.Refresh) AndAlso (e.Uri.OriginalString = "StaticPage.xaml") Then
        e.Cancel = True
    End If
End Sub

Commenti

Questi argomenti dell'evento contengono informazioni sullo spostamento richiesto e vengono passati ai gestori dell'evento Navigation , implementato dai seguenti elementi:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs incapsula i dettagli seguenti della richiesta di navigazione:

• Avvio spostamento: NavigationMode, Navigator, IsNavigationInitiator.

• Contenuto di spostamento: Uri, Content.

• Richiesta di spostamento: WebRequest.

• Stato di navigazione: ExtraData, ContentStateToSave, TargetContentState.

Queste informazioni consentono di valutare la natura della richiesta di navigazione e di visualizzare e aggiornare i dettagli della richiesta specificati prima che si verifichi la navigazione.

In base alle informazioni sulla richiesta di navigazione fornite da NavigatingCancelEventArgso in base allo stato o al codice specifico dell'applicazione, è possibile impedire completamente lo spostamento impostando la Cancel proprietà su true (per impostazione predefinita, Cancel è false).

Proprietà

Nome	Descrizione
Content	Ottiene un riferimento all'oggetto contenuto a cui si sta spostando.
ContentStateToSave	Ottiene o imposta l'oggetto CustomContentState associato alla voce della cronologia di spostamento indietro per la pagina da cui si sposta la pagina.
ExtraData	Ottiene i dati Object facoltativi passati all'avvio della navigazione.
IsNavigationInitiator	Indica se lo strumento di spostamento (NavigationWindow, Frame) specificato da Navigator sta eseguendo la manutenzione di questo spostamento o se lo strumento di spostamento padre esegue questa operazione.
NavigationMode	Ottiene un NavigationMode valore che indica il tipo di navigazione che si sta verificando.
Navigator	Strumento di navigazione che ha generato questo evento.
TargetContentState	Ottiene l'oggetto CustomContentState a cui applicare il contenuto a cui passare.
Uri	Ottiene l'URI (Uniform Resource Identifier) per il contenuto a cui si passa.
WebRequest	Ottiene l'oggetto WebRequest utilizzato per richiedere il contenuto specificato.

Vedi anche

• Navigating