NavigatingCancelEventArgs Clase

Definición

Espacio de nombres:

System.Windows.Navigation

Ensamblado:

PresentationFramework.dll

Proporciona datos para el 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

Herencia

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Ejemplos

En el ejemplo siguiente se muestra cómo controlar Navigating para detectar si se realizó una solicitud para actualizar el contenido estático y, si lo era, cómo cancelar la solicitud.

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

Comentarios

Estos argumentos de evento contienen información sobre la navegación solicitada y se pasan a los controladores del evento Navigationing , que se implementa mediante lo siguiente:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs encapsula los detalles siguientes de la solicitud de navegación:

• Iniciación de navegación: NavigationMode, Navigator, IsNavigationInitiator.

• Contenido de navegación: Uri, Content.

• Solicitud de navegación: WebRequest.

• Estado de navegación: ExtraData, ContentStateToSave, TargetContentState.

Esta información le permite evaluar la naturaleza de la solicitud de navegación y ver y actualizar los detalles de solicitud especificados antes de que se produzca la navegación.

En función de la información de solicitud de navegación proporcionada por NavigatingCancelEventArgs, o en función del estado o el código específicos de la aplicación, puede impedir completamente la navegación estableciendo la Cancel propiedad true en (de forma predeterminada, Cancel es false).

Propiedades

Cancel	Obtiene o establece un valor que indica si se debe cancelar el evento. (Heredado de CancelEventArgs)
Content	Obtiene una referencia al objeto de contenido al que se navega.
ContentStateToSave	Obtiene o establece el objeto CustomContentState asociado a la entrada del historial de retroceso de navegación de la página a la que se navega.
ExtraData	Obtiene el objeto Object de datos opcionales que se pasó cuando comenzó la navegación.
IsNavigationInitiator	Indica si el navegador (NavigationWindow, el objeto Frame) especificado por Navigator está atendiendo esta navegación o si lo está haciendo un navegador primario.
NavigationMode	Obtiene un valor de NavigationMode que indica el tipo de navegación que está en curso.
Navigator	Navegador que generó este evento.
TargetContentState	Obtiene el objeto CustomContentState que se va a aplicar al contenido al que se navega.
Uri	Obtiene el identificador uniforme de recursos (URI) del contenido al que se va a ir.
WebRequest	Obtiene el objeto WebRequest que se usa para solicitar el contenido especificado.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• Navigating