NavigatingCancelEventArgs Classe

Definizione

Spazio dei nomi:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Specifica 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 sulla struttura di spostamento richiesta 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 navigazione: NavigationMode, Navigator, IsNavigationInitiator.

• Contenuto di spostamento: Uri, Content.

• Richiesta di navigazione: WebRequest.

• Stato di navigazione: ExtraData, ContentStateToSave, TargetContentState.

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

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à

Cancel	Ottiene o imposta un valore che indica se l'evento debba essere annullato. (Ereditato da CancelEventArgs)
Content	Ottiene un riferimento all'oggetto contenuto verso il quale si effettua la navigazione.
ContentStateToSave	Ottiene o imposta l'oggetto CustomContentState associato alla voce della cronologia di navigazione all'indietro per la pagina dalla quale si effettua la navigazione.
ExtraData	Ottiene l'oggetto dati Object facoltativo passato all'inizio della navigazione.
IsNavigationInitiator	Indica se la navigazione è servita dallo strumento di navigazione (NavigationWindow, Frame) specificato da Navigator oppure da uno strumento padre.
NavigationMode	Ottiene un valore NavigationMode che indica il tipo di navigazione in atto.
Navigator	Strumento di spostamento che ha generato l'evento.
TargetContentState	Ottiene l'oggetto CustomContentState da applicare al contenuto verso il quale si effettua la navigazione.
Uri	Ottiene l'URI (Uniform Resource Identifier) per il contenuto verso cui si effettua la navigazione.
WebRequest	Ottiene l'oggetto WebRequest utilizzato per richiedere il contenuto specificato.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Navigating