NavigatingCancelEventArgs Classe

Definição

Namespace:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Fornece dados para o 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

Herança

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Exemplos

O exemplo a seguir mostra como lidar Navigating para detectar se uma solicitação para atualizar o conteúdo estático foi feita e, se houver, como cancelar a solicitação.

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

Comentários

Esses argumentos de evento contêm informações sobre a navegação solicitada e são passados para manipuladores do evento Navigating , que é implementado pelo seguinte:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs encapsula os seguintes detalhes da solicitação de navegação:

• Iniciação de Navegação: NavigationMode, , Navigator. IsNavigationInitiator

• Conteúdo de Navegação: Uri, Content.

• Solicitação de Navegação: WebRequest.

• Estado de navegação: ExtraData, , ContentStateToSave. TargetContentState

Essas informações permitem que você avalie a natureza da solicitação de navegação e exiba e atualize os detalhes da solicitação especificada antes da navegação ocorrer.

Com base nas informações de solicitação de navegação fornecidas por NavigatingCancelEventArgs, ou com base no estado ou código específico do aplicativo, você pode impedir completamente a navegação definindo a Cancel propriedade true como (por padrão, Cancel é false).

Propriedades

Nome	Description
Content	Obtém uma referência ao objeto de conteúdo que está sendo navegado.
ContentStateToSave	Obtém ou define o CustomContentState objeto associado à entrada de histórico de navegação de fundo para a página da qual está sendo navegada.
ExtraData	Obtém os dados Object opcionais que foram passados quando a navegação foi iniciada.
IsNavigationInitiator	Indica se o navegador (NavigationWindow, Frame) especificado está Navigator atendendo a essa navegação ou se um navegador pai está fazendo isso.
NavigationMode	Obtém um NavigationMode valor que indica o tipo de navegação que está ocorrendo.
Navigator	O navegador que gerou esse evento.
TargetContentState	Obtém o CustomContentState objeto que deve ser aplicado ao conteúdo que está sendo navegado.
Uri	Obtém o URI (uniform resource identifier) para o conteúdo que está sendo navegado.
WebRequest	Obtém o WebRequest objeto usado para solicitar o conteúdo especificado.

Confira também

• Navigating