NavigatingCancelEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные для события Navigating.
public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgspublic class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgstype NavigatingCancelEventArgs = class
inherit CancelEventArgsPublic Class NavigatingCancelEventArgs
Inherits CancelEventArgs- Наследование
Примеры
В следующем примере показано, как выполнить обработку 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
Комментарии
Эти аргументы события содержат сведения о запрошенной навигации и передаются обработчикам события Навигация , которое реализуется следующим образом:
NavigatingCancelEventArgs инкапсулирует следующие сведения о запросе навигации:
Запуск навигации: NavigationMode, Navigator, IsNavigationInitiator.
Запрос навигации: 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) |
