NavigatingCancelEventArgs Класс

Определение

public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs

public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs

type NavigatingCancelEventArgs = class
    inherit CancelEventArgs

Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

Наследование

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Примеры

В следующем примере показано, как выполнить обработку Navigating, чтобы определить, был ли запрос на обновление статического содержимого был сделан, и если таковой был, как отменить запрос.The following example shows how to handle Navigating to detect whether a request to refresh static content was made, and if one was, how to cancel the request.

Navigating.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

Комментарии

Эти аргументы события содержат сведения о запрошенной навигации и передаются обработчикам события навигации , которое реализуется следующим образом:These event arguments contain information about the navigation that was requested, and are passed to handlers of the Navigating event, which is implemented by the following:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs инкапсулирует следующие сведения о запросе навигации:NavigatingCancelEventArgs encapsulates the following details of the navigation request:

• Инициация навигации: NavigationMode, Navigator, IsNavigationInitiator.Navigation Initiation: NavigationMode, Navigator, IsNavigationInitiator.

• Содержимое навигации: Uri, Content.Navigation Content: Uri, Content.

• Запрос навигации: WebRequest.Navigation Request: WebRequest.

• Состояние навигации: ExtraData, ContentStateToSave, TargetContentState.Navigation State: ExtraData, ContentStateToSave, TargetContentState.

Эти сведения позволяют оценивать природу запроса навигации, а также просматривать и обновлять указанные сведения о запросе перед переходом.This information allows you to both evaluate the nature of the navigation request, and view and update specified request details before navigation occurs.

На основе сведений о запросе навигации, предоставленных NavigatingCancelEventArgs, или в зависимости от состояния приложения или кода, можно полностью запретить навигацию, задав свойству Cancel значение true (по умолчанию Cancel false).Based on the navigation request information provided by NavigatingCancelEventArgs, or based on application-specific state or code, you can completely prevent navigation by setting the Cancel property to true (by default, Cancel is false).

Свойства

Методы

Применяется к

Дополнительно

• Navigating