NavigationService Classe

Definição

public ref class NavigationService sealed

public sealed class NavigationService

type NavigationService = class

Public NotInheritable Class NavigationService

Herança

Object

NavigationService

Comentários

NavigationService encapsula a capacidade de baixar conteúdo no contexto de uma navegação no estilo navegador.

O conteúdo pode ser qualquer tipo de objeto do .NET Framework e arquivos HTML. Em geral, no entanto, as páginas são as preferenciais como a maneira de empacotar conteúdo para navegação (consulte Page).

O conteúdo pode ser navegado fornecendo uma instância de um objeto e chamando uma sobrecarga do Navigate método que aceita um objeto:

• NavigationService.Navigate(Object)
• NavigationService.Navigate(Object, Object)

Como alternativa, o conteúdo pode ser navegado passando um URI relativo ou absoluto para uma das sobrecargas de Navigate método que aceita um URI:

• NavigationService.Navigate(Uri)
• NavigationService.Navigate(Uri, Object)
• NavigationService.Navigate(Uri, Object, Boolean)

Quando o conteúdo for navegado por URI, NavigationService retornará um objeto que contém o conteúdo.

O tempo de vida de uma navegação pode ser acompanhado pelos seguintes eventos:

• Navigating
• Navigated
• NavigationProgress
• NavigationFailed
• NavigationStopped
• LoadCompleted
• FragmentNavigation

Nem todos os eventos são gerados sempre que uma navegação ocorre; o conjunto de eventos gerados é determinado pelo tipo de navegação que ocorre (conteúdo ou fragmento de conteúdo) e como a navegação é concluída (cancelada, interrompida ou com falha).

A figura a seguir ilustra a sequência na qual esses eventos são gerados:

página

Durante ou após uma navegação, NavigationService fornece informações sobre o conteúdo que está sendo navegado, incluindo o URI do conteúdo que está sendo navegado para (Source), o URI do conteúdo atual (CurrentSource) e um objeto que contém o conteúdo que foi navegado para (Content).

Quando o conteúdo é navegado, NavigationService registra a navegação como uma entrada no histórico de navegação. Uma entrada é adicionada ao histórico de navegação de volta quando ocorre uma nova navegação, chamando o Navigate método ou navegando até uma entrada no histórico de navegação, chamando GoForward. Uma entrada é adicionada ao histórico de navegação de encaminhamento navegando até uma entrada no histórico de navegação de volta, chamando GoBack. CanGoBack e CanGoForward informe se há entradas no histórico de navegação para trás e para frente, respectivamente. Além disso, a entrada mais recente no histórico de navegação traseira pode ser removida chamando RemoveBackEntry.

Por padrão, NavigationService não armazena uma instância de um objeto de conteúdo no histórico de navegação. Em vez disso, NavigationService cria uma nova instância do objeto de conteúdo sempre que ele é navegado usando o histórico de navegação. Esse comportamento foi projetado para evitar o consumo excessivo de memória quando grandes números e grandes partes de conteúdo estão sendo navegadas. Consequentemente, o estado do conteúdo não é lembrado de uma navegação para a outra. No entanto, o WPF fornece várias técnicas pelas quais você pode armazenar um pedaço de estado para um conteúdo no histórico de navegação.

Usando AddBackEntry, você também pode se lembrar de vários conjuntos de estado para uma única instância de página.

NavigationService é uma sealed classe e, portanto, não pode ser instanciada; em vez disso, NavigationService é usada por navegadores para habilitar a navegação. No WPF, há dois navegadores: NavigationWindow e Frame.

Visualmente, os XBAPs usam o Internet Explorer como navegador para fornecer uma experiência integrada do usuário. Fisicamente, no entanto, os XBAPs realmente usam NavigationWindow como navegador; a MainWindow propriedade de um XBAP em execução no Internet Explorer retornará uma referência ao NavigationWindowe o histórico de navegação gerenciado pelo NavigationWindow é integrado ao histórico de navegação gerenciado pelo Internet Explorer das seguintes maneiras:

• Quando o conteúdo é navegado por chamada Navigatee GoBackGoForward de dentro de um XBAP, as entradas de histórico de navegação relevantes também são adicionadas ao histórico de navegação do Internet Explorer.
• Quando as entradas na interface do usuário de navegação do Internet Explorer são selecionadas NavigationService , o Internet Explorer faz com que navegue para trás ou encaminhe para o conteúdo associado a essas entradas.

Para obter mais informações sobre o suporte ao XBAP, consulte perguntas frequentes sobre XBAP (aplicativos hospedados por navegador) do WPF.