JournalEntry Classe

Definição

public ref class JournalEntry : System::Windows::DependencyObject, System::Runtime::Serialization::ISerializable

[System.Serializable]
public class JournalEntry : System.Windows.DependencyObject, System.Runtime.Serialization.ISerializable

[<System.Serializable>]
type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Herança

Object

DispatcherObject

DependencyObject

JournalEntry

Atributos

SerializableAttribute

Implementações

ISerializable

Exemplos

O exemplo seguinte mostra como recuperar o objeto mais recente JournalEntry da pilha de navegação traseira para obter os Name valores da propriedade e Source .

void removeJournalEntryButton_Click(object sender, RoutedEventArgs e)
{
    // If there are journal entries on the back navigation stack
    if (this.NavigationService.CanGoBack)
    {
        // Remove and get the most recent entry on the back navigation stack
        JournalEntry journalEntry = this.NavigationService.RemoveBackEntry();

        string name = journalEntry.Name;
        string uri = journalEntry.Source.OriginalString;
        MessageBox.Show(name + " [" + uri + "] removed from back navigation.");
    }
}

Private Sub removeJournalEntryButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' If there are journal entries on the back navigation stack
    If Me.NavigationService.CanGoBack Then
        ' Remove and get the most recent entry on the back navigation stack
        Dim journalEntry As JournalEntry = Me.NavigationService.RemoveBackEntry()

        Dim name As String = journalEntry.Name
        Dim uri As String = journalEntry.Source.OriginalString
        MessageBox.Show(name & " [" & uri & "] removed from back navigation.")
    End If
End Sub

Observações

O Windows Presentation Foundation implementa um serviço de histórico de navegação que armazena uma entrada para cada peça de conteúdo anteriormente explorada, tal como o histórico de navegação num navegador. O histórico de navegação compreende duas pilhas, uma que recorda o histórico de navegação para trás e outra que recorda o histórico de navegação para a frente.

Uma entrada para o item atual é adicionada ao histórico de navegação retroativa quando ocorre uma navegação para a frente. Isto ocorre nas seguintes situações:

• O Navigate método chama-se (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• O GoForward método chama-se (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• O botão avançar na interface de navegação que é exibido pelo navegador atual (XBAP, NavigationWindow, Frame).

Da mesma forma, uma entrada para o item atual é adicionada ao histórico de navegação anterior antes de ocorrer uma navegação para trás, o que acontece quando:

• O GoBack método chama-se (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• O botão de voltar na interface de navegação que é exibido pelo navegador atual (XBAP, NavigationWindow, Frame).

Cada entrada no histórico de navegação para trás e para a frente é uma instância da JournalEntry classe.

Cada JournalEntry objeto encapsula informação sobre uma navegação particular, incluindo um nome para a entrada (Name), se a entrada é mantida ativa (KeepAlive) e o identificador uniforme de recurso (URI) para o conteúdo que é navegado até (Source).

Pode recuperar todos os JournalEntry objetos no histórico de navegação anterior enumerando as NavigationWindow.BackStack propriedades ou.Frame.BackStack Para o histórico de navegação para a frente, pode recuperar todos os JournalEntry objetos enumerando as NavigationWindow.ForwardStack propriedades ou.Frame.ForwardStack

Se precisares de remover o objeto mais recente JournalEntry do histórico de navegação retroativa, para impedir a navegação até ele, por exemplo, podes chamar o RemoveBackEntry método (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), que remove o JournalEntry objeto e devolve uma referência a ele.

No entanto, não pode adicionar JournalEntry objetos ao histórico de navegação, porque não pode nem instanciar nem derivar de JournalEntry, e porque nenhum tipo implementa um membro para o fazer. No entanto, pode adicionar objetos personalizados CustomContentState ao histórico de navegação retroativa chamando o AddBackEntry método (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService adiciona o CustomContentState objeto a um objeto criado JournalEntry internamente, que depois é adicionado ao histórico de navegação retroativa.