Compartilhar via


NavigatingCancelEventArgs Classe

Definição

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
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:

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

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)

Aplica-se a

Confira também