NavigatingCancelEventArgs Класс

Определение

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

System.Windows.Navigation

Сборка:

PresentationFramework.dll

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

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

Свойства

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

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• Navigating