NavigatingCancelEventArgs Класс

Определение

Пространство имен:

System.Windows.Navigation

Сборка:

PresentationFramework.dll

Предоставляет данные для события навигации .

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 , был ли выполнен запрос на обновление статического содержимого и как отменить запрос.

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

Комментарии

Эти аргументы событий содержат сведения о запрошенной навигации и передаются обработчикам события навигации , реализуемого следующим образом:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs инкапсулирует следующие сведения о запросе навигации:

• Запуск навигации: NavigationMode, Navigator, IsNavigationInitiator.

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

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

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

Эта информация позволяет оценивать характер запроса навигации, а также просматривать и обновлять указанные сведения о запросе перед переходом.

На основе сведений о запросе навигации, предоставленных NavigatingCancelEventArgsили основанных на состоянии или коде приложения, вы можете полностью предотвратить навигацию, установив Cancel для свойства true значение (по умолчанию Cancel — false).

Свойства

Имя	Описание
Content	Возвращает ссылку на объект содержимого, к которому перемещается переход.
ContentStateToSave	Возвращает или задает CustomContentState объект, связанный с записью журнала навигации назад для перемещаемой страницы.
ExtraData	Возвращает необязательные данные Object , переданные при запуске навигации.
IsNavigationInitiator	Указывает, является ли навигатор (NavigationWindow, Frame) заданным Navigator обслуживанием этой навигации или родительским навигатором.
NavigationMode	NavigationMode Возвращает значение, указывающее тип навигации, который происходит.
Navigator	Навигатор, вызвавшее это событие.
TargetContentState	CustomContentState Возвращает объект, который должен применяться к содержимому, к которому перемещается.
Uri	Возвращает универсальный идентификатор ресурса (URI) для перемещаемого содержимого.
WebRequest	Возвращает объект, используемый WebRequest для запроса указанного содержимого.

См. также раздел

• Navigating