NavigatingCancelEventArgs Clase

Definición

Proporciona datos para el evento Navigating.Provides data for the Navigating event.

public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs
public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs
type NavigatingCancelEventArgs = class
    inherit CancelEventArgs
Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs
Herencia
NavigatingCancelEventArgs

Ejemplos

En el ejemplo siguiente se muestra cómo controlar Navigating para detectar si se ha realizado una solicitud para actualizar el contenido estático y, si es el caso, cómo cancelar la solicitud.The following example shows how to handle Navigating to detect whether a request to refresh static content was made, and if one was, how to cancel the request.

Navigating.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 que se solicitó y se pasan a los controladores del evento de navegación, que se implementa mediante lo siguiente:These event arguments contain information about the navigation that was requested, and are passed to handlers of the Navigating event, which is implemented by the following:

NavigatingCancelEventArgs encapsula los siguientes detalles de la solicitud de navegación:NavigatingCancelEventArgs encapsulates the following details of the navigation request:

Esta información permite evaluar la naturaleza de la solicitud de navegación y ver y actualizar los detalles de las solicitudes especificadas antes de que se produzca la navegación.This information allows you to both evaluate the nature of the navigation request, and view and update specified request details before navigation occurs.

En función de la información de la solicitud de navegación proporcionada por NavigatingCancelEventArgs, o según el código o el estado específico de la aplicación, puede evitar completamente la navegación estableciendo la propiedad Cancel en true (de forma predeterminada, Cancel es false).Based on the navigation request information provided by NavigatingCancelEventArgs, or based on application-specific state or code, you can completely prevent navigation by setting the Cancel property to true (by default, Cancel is false).

Propiedades

Cancel

Obtiene o establece un valor que indica si se debe cancelar el evento.Gets or sets a value indicating whether the event should be canceled.

(Heredado de CancelEventArgs)
Content

Obtiene una referencia al objeto de contenido al que se navega.Gets a reference to the content object that is being navigated to.

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.Gets or sets the CustomContentState object that is associated with the back navigation history entry for the page being navigated from.

ExtraData

Obtiene el objeto Object de datos opcionales que se pasó cuando comenzó la navegación.Gets the optional data Object that was passed when navigation started.

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.Indicates whether the navigator (NavigationWindow, Frame) that is specified by Navigator is servicing this navigation, or whether a parent navigator is doing so.

NavigationMode

Obtiene un valor de NavigationMode que indica el tipo de navegación que está en curso.Gets a NavigationMode value that indicates the type of navigation that is occurring.

Navigator

Navegador que generó este evento.The navigator that raised this event.

TargetContentState

Obtiene el objeto CustomContentState que se va a aplicar al contenido al que se navega.Gets the CustomContentState object that is to be applied to the content being navigated to.

Uri

Obtiene el identificador uniforme de recursos (URI) del contenido al que se va a ir.Gets the uniform resource identifier (URI) for the content being navigated to.

WebRequest

Obtiene el objeto WebRequest que se usa para solicitar el contenido especificado.Gets the WebRequest object that is used to request the specified content.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también: