NavigatingCancelEventArgs Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные для события Navigating.
public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs
public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs
type NavigatingCancelEventArgs = class
inherit CancelEventArgs
Public 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 |
Получает ссылку на объект содержимого, к которому осуществляется переход. |
Content |
Получает или задает объект CustomContentState, связанный с записью журнала обратной навигации для страницы, с которой осуществляется переход. |
Extra |
Получает необязательные данные Object, переданные при инициировании перехода. |
Is |
Указывает, какой навигатор (NavigationWindow, Frame) обслуживает данный переход: указанный в свойстве Navigator или родительский. |
Navigation |
Возвращает значение NavigationMode, указывающее тип выполняемого перехода. |
Navigator |
Навигатор, сгенерировавший данное событие. |
Target |
Получает объект CustomContentState, применяемый к содержимому, к которому осуществляется переход. |
Uri |
Возвращает универсальный код ресурса (URI) содержимого, к которому осуществляется переход. |
Web |
Получает объект WebRequest, используемый для запроса заданного содержимого. |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
Get |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
Get |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
Memberwise |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
To |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Продукт | Версии |
---|---|
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: