NavigationService Класс

Определение

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

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

Комментарии

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 или перехода к записи в журнале переходов вперед путем вызова GoForward.An 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 является sealedным классом и поэтому не может быть создан. Вместо этого NavigationService используется навигаторами для включения навигации.NavigationService is a sealed class and therefore cannot be instantiated; instead, NavigationService is used by navigators to enable navigation. В WPF есть два навигатора: NavigationWindow и Frame.In WPF, there are two navigators: NavigationWindow and Frame.

Визуально XBAPXBAPs использовать Internet Explorer 7Internet Explorer 7 в качестве навигатора, чтобы обеспечить Интегрированное взаимодействие с пользователем.Visually, 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, а журнал навигации, который управляется NavigationWindow, интегрируется с журналом переходов, управляемым Internet Explorer 7Internet Explorer 7, следующим образом.Physically, 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, Internet ExplorerInternet Explorer) и, следовательно, не могут быть перемещены из ИПUI навигации каждого из них (см. 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

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

CanGoForward

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

Content

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

CurrentSource

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

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)

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

Equals(Object)

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

(Унаследовано от Object)
GetHashCode()

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

(Унаследовано от Object)
GetNavigationService(DependencyObject)

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

GetType()

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

(Унаследовано от Object)
GoBack()

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

GoForward()

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

MemberwiseClone()

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

(Унаследовано от Object)
Navigate(Object)

Выполняет асинхронный переход к содержимому, которое находится в объекте.Navigate asynchronously to content that is contained by an 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)

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

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)

Выполняет асинхронный переход к содержимому источника с указанным 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()

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

RemoveBackEntry()

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

StopLoading()

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

ToString()

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

(Унаследовано от Object)

События

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

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

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

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

NavigationFailed

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

NavigationProgress

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

NavigationStopped

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

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