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 manipular 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 especificados antes que a navegação ocorra.

Com base nas informações de solicitação de navegação fornecidas pelo NavigatingCancelEventArgsou 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

Cancel	Obtém 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 se está navegando.
ContentStateToSave	Obtém ou define o objeto CustomContentState associado à entrada do histórico de navegação reverso para a página para a qual se está navegando.
ExtraData	Obtém os dados opcionais Object que foram passados quando a navegação iniciou.
IsNavigationInitiator	Indica se o navegador (NavigationWindow, Frame) que é especificado por Navigator está atendendo a esta navegação ou se um navegador pai está fazendo isso.
NavigationMode	Obtém um valor NavigationMode que indica o tipo de navegação que está ocorrendo.
Navigator	O navegador que gerou esse evento.
TargetContentState	Obtém o objeto CustomContentState a ser aplicado ao conteúdo para o qual se está navegando.
Uri	Obtém o URI (Uniform Resource Identifier) do conteúdo até o qual se está navegando.
WebRequest	Obtém o objeto WebRequest que é usado para solicitar o conteúdo especificado.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Navigating