NavigationService NavigationService NavigationService NavigationService Class

Определение

Содержит методы, свойства и события для поддержки переходов.Contains methods, properties, and events to support navigation.

public ref class NavigationService sealed
public sealed class NavigationService
type NavigationService = class
Public NotInheritable Class NavigationService
Наследование
NavigationServiceNavigationServiceNavigationServiceNavigationService

Комментарии

NavigationServiceинкапсулирует возможность загрузки содержимого в контексте навигации в стиле браузера.NavigationService encapsulates the ability to download content within the context of a browser-style navigation.

Содержимым может быть любой тип .NET Frameworkного объекта и HTML-файлов.Content can be any type of .NET Framework object and HTML files. Однако в общем случае страницы являются предпочтительным способом упаковки содержимого для навигации (см. раздел Page).In general, however, pages are the preferred as the way to package content for navigation (see Page).

Переход к содержимому можно выполнить, предоставив экземпляр объекта и вызвав перегрузку Navigate метода, принимающего объект:Content can be navigated to by providing an instance of an object and calling an overload of the Navigate method that accepts an object:

Кроме того, можно переходить к содержимому, передав относительный или абсолютный URI в Navigate одну из перегрузок метода, принимающую URI:Alternatively, content can be navigated to by passing a relative or absolute URI to one of the Navigate method overloads that accepts a URI:

При переходе к содержимому по URI NavigationService возвращает объект, содержащий содержимое.When content is navigated to by URI, NavigationService will return an object that contains the content.

Время существования навигации можно контролировать с помощью следующих событий:The lifetime of a navigation can be tracked through the following events:

Не все события возникают каждый раз при переходе; набор вызываемых событий определяется типом навигации (содержимым или фрагментом содержимого) и способом завершения навигации (отменен, остановлен или неудачно).Not all events are raised each time that a navigation occurs; the set of events that are raised is determined by the type of navigation that occurs (content or content fragment) and how the navigation completes (canceled, stopped, or failed).

На следующем рисунке показана последовательность, в которой вызываются эти события:The following figure illustrates the sequence in which these events are raised:

Блок-схема навигации по страницамPage navigation flow chart

Во время или после перехода NavigationService предоставляет сведения о содержимом, к которому осуществляется переход, включая URI содержимого, к которому осуществляется переход (Source), URI текущего содержимого (CurrentSource) и объект, содержащий содержимое, к которому осуществлялся переходContent().During or after a navigation, NavigationService provides information about the content that is being navigated to, including the URI of the content being navigated to (Source), the URI of the current content (CurrentSource), and an object that contains the content that was navigated to (Content).

При переходе к NavigationService содержимому записывает навигацию в виде записи в журнале навигации.When content is navigated to, NavigationService records the navigation as an entry in navigation history. Запись добавляется в журнал переходов назад, когда происходит новая навигация, путем вызова Navigate метода или перехода к записи в журнале прямой навигации путем вызова. GoForwardAn entry is added to back navigation history when either a new navigation occurs, by calling the Navigate method, or by navigating to an entry in forward navigation history, by calling GoForward. Запись добавляется в журнал переходов вперед путем перехода к записи в журнале переходов назад путем вызова метода GoBack.An entry is added to forward navigation history by navigating to an entry in back navigation history, by calling GoBack. CanGoBackи CanGoForward сообщают, есть ли записи в журнале переходов назад и вперед соответственно.CanGoBack and CanGoForward report whether there are entries in back and forward navigation history, respectively. Кроме того, последнюю запись в журнале переходов назад можно удалить, вызвав RemoveBackEntryметод.Also, the most recent entry in back navigation history can be removed by calling RemoveBackEntry.

По умолчанию NavigationService не сохраняет экземпляр объекта содержимого в журнале переходов.By default, NavigationService does not store an instance of a content object in navigation history. Вместо этого NavigationService создает новый экземпляр объекта содержимого при каждом переходе к с помощью журнала навигации.Instead, NavigationService creates a new instance of the content object each time it is navigated to by using navigation history. Такое поведение предназначено для предотвращения чрезмерного потребления памяти при переходе к большим числам и большим фрагментам содержимого.This behavior is designed to avoid excessive memory consumption when large numbers and large pieces of content are being navigated to. Следовательно, состояние содержимого не запоминается при переходе к следующему.Consequently, the state of the content is not remembered from one navigation to the next. Однако WPF предоставляет несколько методов, с помощью которых можно хранить фрагмент содержимого в журнале переходов.However, WPF provides several techniques by which you can store a piece of state for a piece of content in navigation history.

С AddBackEntryпомощью можно также запомнить несколько наборов состояний для одного экземпляра страницы.Using AddBackEntry, you can also remember multiple sets of state for a single page instance.

NavigationServiceявляется классом и поэтому не может быть создан. NavigationService вместо этого он используется навигаторами для включения навигации. sealedNavigationService is a sealed class and therefore cannot be instantiated; instead, NavigationService is used by navigators to enable navigation. В WPF есть два навигатора: NavigationWindow и. FrameIn WPF, there are two navigators: NavigationWindow and Frame.

Визуально Internet Explorer 7Internet Explorer 7 используйте в качестве навигатора, чтобы обеспечить Интегрированное взаимодействие с пользователем. XBAPXBAPsVisually, XBAPXBAPs use Internet Explorer 7Internet Explorer 7 as a navigator, to provide an integrated user experience. Физически XBAPXBAPs , однако, используется NavigationWindow в MainWindow качестве навигатора XBAPXBAP ; свойство выполняемого в Internet Explorer 7Internet Explorer 7 возвращает ссылку NavigationWindowна, и журнал переходов, который управляется интегрирован с журналом навигации, который Internet Explorer 7Internet Explorer 7 управляется следующими способами: NavigationWindowPhysically, however, XBAPXBAPs actually use NavigationWindow as the navigator; the MainWindow property of an XBAPXBAP running in Internet Explorer 7Internet Explorer 7 will return a reference to the NavigationWindow, and the navigation history that is managed by the NavigationWindow is integrated with the navigation history that is managed by Internet Explorer 7Internet Explorer 7 in the following ways:

  • При переходе к содержимому с помощью Navigateвызова GoBack, и GoForward из XBAPXBAP соответствующих записей журнала навигации также добавляются в Internet Explorer 7Internet Explorer 7 журнал переходов.When content is navigated to by calling Navigate, GoBack, and GoForward from within an XBAPXBAP the relevant navigation history entries are also added to Internet Explorer 7Internet Explorer 7 navigation history.

  • Если выбраны записи Internet Explorer 7Internet Explorer 7 в ИПUI области навигации, Internet Explorer 7Internet Explorer 7 происходит NavigationService переход назад или вперед к содержимому, связанному с этими записями.When entries in the Internet Explorer 7Internet Explorer 7 navigation ИПUI are selected, Internet Explorer 7Internet Explorer 7 causes NavigationService to navigate back or forwards to the content that is associated with those entries.

Примечание

Frame Может предоставить собственный журнал навигации или использовать журнал навигации навигатора, на котором размещается.A Frame can provide its own navigation history, or use the navigation history of the navigator that hosts it. Если Frame предоставляет собственный журнал навигации, он может отображать собственную навигацию ИПUI для перемещения по записям в журнале навигации; эти записи не добавляются в журнал навигации главного навигатора (NavigationWindow, Frame ИПUI , Internet ExplorerInternet Explorer) и, следовательно, невозможно перейти к переходу по каждой из них (см JournalOwnership.).If Frame provides its own navigation history, it can display its own navigation ИПUI to navigate through the entries in navigation history; those entries are not added to the navigation history of the host navigator (NavigationWindow, Frame, Internet ExplorerInternet Explorer) and, consequently, cannot be navigated to from the navigation ИПUI of each (see JournalOwnership).

Свойства

CanGoBack CanGoBack CanGoBack CanGoBack

Возвращает значение, указывающее, имеются ли записи в журнале переходов назад.Gets a value that indicates whether there is at least one entry in back navigation history.

CanGoForward CanGoForward CanGoForward CanGoForward

Возвращает значение, указывающее, имеются ли записи в журнале переходов вперед.Gets a value that indicates whether there is at least one entry in forward navigation history.

Content Content Content Content

Возвращает или задает указатель на объект с текущим содержимым.Gets or sets a reference to the object that contains the current content.

CurrentSource CurrentSource CurrentSource CurrentSource

Возвращает универсальный код ресурса (URI) содержимого, к которому был осуществлен последний переход.Gets the URI of the content that was last navigated to.

Source Source Source Source

Возвращает или задает URI текущего содержимого или URI нового содержимого, к которому осуществляется переход.Gets or sets the URI of the current content, or the URI of new content that is currently being navigated to.

Методы

AddBackEntry(CustomContentState) AddBackEntry(CustomContentState) AddBackEntry(CustomContentState) AddBackEntry(CustomContentState)

Добавляет запись в журнал переходов назад, содержащий объект CustomContentState.Adds an entry to back navigation history that contains a CustomContentState object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetNavigationService(DependencyObject) GetNavigationService(DependencyObject) GetNavigationService(DependencyObject) GetNavigationService(DependencyObject)

Возвращает указатель на NavigationService для навигатора, содержимое которого находится в заданном DependencyObject.Gets a reference to the NavigationService for the navigator whose content contains the specified DependencyObject.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GoBack() GoBack() GoBack() GoBack()

Выполняет переход к последней записи журнала переходов назад, если он содержит записи.Navigates to the most recent entry in back navigation history, if there is one.

GoForward() GoForward() GoForward() GoForward()

Выполняет переход к последней записи журнала переходов назад, если он содержит записи.Navigate to the most recent entry in forward navigation history, if there is one.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Navigate(Object) Navigate(Object) Navigate(Object) Navigate(Object)

Выполняет асинхронный переход к содержимому, которое находится в объекте.Navigate asynchronously to content that is contained by an object.

Navigate(Object, Object) Navigate(Object, Object) Navigate(Object, Object) Navigate(Object, Object)

Выполняет асинхронный переход к содержимому, которое находится в объекте, и передает объект с данными, предназначенными для использования в процессе перехода.Navigate asynchronously to content that is contained by an object, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri) Navigate(Uri) Navigate(Uri) Navigate(Uri)

Выполняет асинхронный переход к содержимому, идентифицируемому URI.Navigate asynchronously to content that is specified by a URI.

Navigate(Uri, Object) Navigate(Uri, Object) Navigate(Uri, Object) Navigate(Uri, Object)

Выполняет асинхронный переход к содержимому источника с указанным URI и передает объект с данными, предназначенными для использования в процессе перехода.Navigate asynchronously to source content located at a URI, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean)

Выполняет асинхронный переход к содержимому источника с указанным URI, передает объект, содержащий состояние перехода для использования в процессе перехода, и выводит содержимое в песочнице.Navigate asynchronously to source content located at a URI, pass an object containing navigation state for processing during navigation, and sandbox the content.

Refresh() Refresh() Refresh() Refresh()

Заново загружает текущее содержимое.Reloads the current content.

RemoveBackEntry() RemoveBackEntry() RemoveBackEntry() RemoveBackEntry()

Удаляет последнюю запись из журнала переходов назад.Removes the most recent journal entry from back history.

StopLoading() StopLoading() StopLoading() StopLoading()

Останавливает дальнейшую загрузку содержимого для текущего запроса перехода.Stops further downloading of content for the current navigation request.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

События

FragmentNavigation FragmentNavigation FragmentNavigation FragmentNavigation

Происходит, когда начинается переход к фрагменту содержимого, что происходит немедленно, если нужный фрагмент находится в текущем содержимом, или после загрузки исходного содержимого XAMLXAML, если нужный фрагмент находится в другом содержимом.Occurs when navigation to a content fragment begins, which occurs immediately, if the desired fragment is in the current content, or after the source XAMLXAML content has been loaded, if the desired fragment is in different content.

LoadCompleted LoadCompleted LoadCompleted LoadCompleted

Генерируется, когда содержимое, к которому осуществлен переход, загружено, проанализировано и начинается его отрисовка.Occurs when content that was navigated to has been loaded, parsed, and has begun rendering.

Navigated Navigated Navigated Navigated

Возникает, когда содержимое, к которому осуществляется переход, найдено и доступно через свойство Content, хотя его загрузка, возможно, еще не завершена.Occurs when the content that is being navigated to has been found, and is available from the Content property, although it may not have completed loading.

Navigating Navigating Navigating Navigating

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

NavigationFailed NavigationFailed NavigationFailed NavigationFailed

Генерируется, когда происходит ошибка при переходе к запрошенному содержимому.Occurs when an error occurs while navigating to the requested content.

NavigationProgress NavigationProgress NavigationProgress NavigationProgress

Происходит периодически во время загрузки, тем самым предоставляя информацию о ходе процесса навигации.Occurs periodically during a download to provide navigation progress information.

NavigationStopped NavigationStopped NavigationStopped NavigationStopped

Генерируется, когда вызван метод StopLoading() или во время выполнения текущего перехода запрошен новый переход.Occurs when the StopLoading() method is called, or when a new navigation is requested while a current navigation is in progress.

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