NavigatingCancelEventArgs Clase
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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.
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
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:
NavigatingCancelEventArgs encapsula los detalles siguientes de la solicitud de navegación:
Iniciación de navegación: NavigationMode, Navigator, IsNavigationInitiator.
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
).
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. |
Content |
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. |
Extra |
Obtiene el objeto Object de datos opcionales que se pasó cuando comenzó la navegación. |
Is |
Indica si el navegador (NavigationWindow, el objeto Frame) especificado por Navigator está atendiendo esta navegación o si lo está haciendo un navegador primario. |
Navigation |
Obtiene un valor de NavigationMode que indica el tipo de navegación que está en curso. |
Navigator |
Navegador que generó este evento. |
Target |
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. |
Web |
Obtiene el objeto WebRequest que se usa para solicitar el contenido especificado. |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
Get |
Sirve como la función hash predeterminada. (Heredado de Object) |
Get |
Obtiene el Type de la instancia actual. (Heredado de Object) |
Memberwise |
Crea una copia superficial del Object actual. (Heredado de Object) |
To |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Producto | Versiones |
---|---|
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: