NavigationService.Navigating NavigationService.Navigating NavigationService.Navigating NavigationService.Navigating Event

Определение

Появляется, когда запрошен новый переход.Occurs when a new navigation is requested.

public:
 event System::Windows::Navigation::NavigatingCancelEventHandler ^ Navigating;
public event System.Windows.Navigation.NavigatingCancelEventHandler Navigating;
member this.Navigating : System.Windows.Navigation.NavigatingCancelEventHandler 
Public Custom Event Navigating As NavigatingCancelEventHandler 

Примеры

В следующем примере показано, как выполнить Navigating обработку запроса на обновление статического содержимого и, если это так, отменить запрос.The following example shows how to handle Navigating to detect whether a request to refresh static content has been made and, if so, 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

Комментарии

Navigatingвызывается при запросе новой навигации, но перед запросом к исходному содержимому, в том числе:Navigating is raised when a new navigation is requested, but before the source content is requested, including when:

  • Вызывается метод Navigate.Navigate is called.

  • GoBackили GoForward вызывается (или выбирается запись из навигации ИПUI).GoBack or GoForward is called (or an entry is selected from a navigation ИПUI).

  • Выполняется переход к фрагменту содержимого.A content fragment is navigated to.

Вы выполняете обработку Navigating , если вам нужно найти соответствующую информацию о запросе навигации перед началом навигации.You handle Navigating if you need to discover pertinent information regarding the navigation request before navigation starts. Эта информация доступна из NavigatingCancelEventArgs объекта, который передается Navigating в обработчик событий.This information is available from the NavigatingCancelEventArgs object that is passed to the Navigating event handler.

Объект для навигации создается и доступен NavigatingCancelEventArgs в параметре; поскольку на этом этапе фактический запрос не сделан, WebRequest при необходимости можно перенастроить объект. WebRequestA WebRequest object for the navigation is created and available from the NavigatingCancelEventArgs parameter; because the actual request hasn't been made at this point, you can reconfigure the WebRequest object, if necessary.

Вы также NavigatingCancelEventArgs можете отменять навигацию, если это необходимо Cancel , установив значение true.You also handle NavigatingCancelEventArgs to cancel navigation, if required, by setting Cancel to true. При отмене навигации другие события навигации не вызываются.If you cancel navigation, no other navigation events are raised.

Примечание

Если приложение размещено в браузере, вы не сможете запретить пользователю переходить от приложения, Navigating отменив событие.If your application is hosted in the browser, you cannot prevent the user from navigating away from your application by canceling the Navigating event.

После перехода к первому фрагменту содержимого по навигатору (NavigationWindow, Frame) каждый фрагмент содержимого, к которому осуществляется переход из, добавляется в журнал переходов.After the first piece of content is navigated to by a navigator (NavigationWindow, Frame), each piece of content that is navigated away from is added to navigation history. Если необходимо сохранить сведения о состоянии содержимого, из которого вы переходите из, можно добавить состояние в запись журнала для этого содержимого, задав ContentStateToSave CustomContentState для объекта.If you need to save state information about the content you are navigating away from, you can add the state to the journal entry for that content by setting ContentStateToSave with a CustomContentState object.

Примечание

При NavigationService вызове Navigating Application.Navigating онApplication также создает событие для объекта.When NavigationService raises Navigating, it also raises Application.Navigating event on the Application object.

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

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