NavigatingCancelEventArgs Classe

Definição

Espaço de Nomes:
System.Windows.Navigation
Assemblagem:
PresentationFramework.dll

Fornece dados para o evento de Navegação .

public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs
public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs
type NavigatingCancelEventArgs = class
    inherit CancelEventArgs
Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs
Herança
Object
EventArgs
CancelEventArgs
NavigatingCancelEventArgs

Exemplos

O exemplo seguinte mostra como detetar Navigating se foi feito um pedido para atualizar conteúdo estático e, se foi, como cancelar o pedido.

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

Observações

Estes argumentos de evento contêm informações sobre a navegação solicitada e são passados aos responsáveis pelo evento de Navegação , que é implementado da seguinte forma:

NavigatingCancelEventArgs Resume os seguintes detalhes do pedido de navegação:

Esta informação permite-lhe avaliar a natureza do pedido de navegação, bem como visualizar e atualizar os detalhes especificados do pedido antes de a navegação ocorrer.

Com base na informação do pedido de navegação fornecida por NavigatingCancelEventArgs, ou com base no estado ou código específico da aplicação, pode impedir completamente a navegação definindo a Cancel propriedade para true (por defeito, Cancel é false).

Propriedades

Name Description
Cancel

Recebe ou define um valor que indica se o evento deve ser cancelado.

(Herdado de CancelEventArgs)
Content

Obtém uma referência ao objeto de conteúdo para o qual está a ser navegado.
ContentStateToSave

Obtém ou define o CustomContentState objeto associado à entrada do histórico de navegação retroativa para a página de onde se está a navegar.
ExtraData

Recebe os dados Object opcionais que foram passados quando a navegação começou.
IsNavigationInitiator

Indica se o navegador (NavigationWindow, Frame) especificado por Navigator está a servir esta navegação, ou se um navegador pai o está a fazer.
NavigationMode

Obtém um NavigationMode valor que indica o tipo de navegação que está a ocorrer.
Navigator

O navegador que levantou este evento.
TargetContentState

Obtém o CustomContentState objeto que deve ser aplicado ao conteúdo para onde se navega.
Uri

Obtém o identificador uniforme de recurso (URI) para o conteúdo para onde se está a navegar.
WebRequest

Obtém o WebRequest objeto que é usado para solicitar o conteúdo especificado.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também