JournalEntry Klas

Definitie

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

Overname

Object

DispatcherObject

DependencyObject

JournalEntry

Kenmerken

SerializableAttribute

Implementeringen

ISerializable

Voorbeelden

In het volgende voorbeeld ziet u hoe u het meest recente JournalEntry object ophaalt uit de backnavigatiestack om de Name waarden en Source eigenschapswaarden op te halen.

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

Opmerkingen

Windows Presentation Foundation implementeert een navigatiegeschiedenisservice waarmee één vermelding wordt opgeslagen voor elk stuk inhoud waarnaar eerder is genavigeerd, net zoals navigatiegeschiedenis in een browser. De navigatiegeschiedenis bestaat uit twee stapels, een stack die de geschiedenis van de navigatie terug onthoudt en een stapels die de navigatiegeschiedenis van de doorstuurserver onthoudt.

Er wordt een vermelding voor het huidige item toegevoegd aan de backnavigatiegeschiedenis wanneer er een vooruitnavigatie plaatsvindt. Dit gebeurt in de volgende situaties:

• De Navigate methode wordt aangeroepen (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• De GoForward methode wordt aangeroepen (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• De knop Doorsturen in de navigatie-UI die wordt weergegeven vanuit de huidige navigator (XBAP, NavigationWindow, ). Frame

Op dezelfde manier wordt een vermelding voor het huidige item toegevoegd aan de navigatiegeschiedenis voordat er een terugnavigatie plaatsvindt, wat gebeurt wanneer:

• De GoBack methode wordt aangeroepen (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• De knop Terug in de navigatie-UI die wordt weergegeven vanuit de huidige navigator (XBAP, NavigationWindow, ). Frame

Elke vermelding in de back- en forwardnavigatiegeschiedenis is een exemplaar van de JournalEntry klasse.

Elk JournalEntry object bevat informatie over een bepaalde navigatie, inclusief een naam voor de vermelding (Name), of de vermelding actief blijft (KeepAlive) en de URI (uniform resource identifier) voor de inhoud waarnaar wordt genavigeerd (Source).

U kunt alle JournalEntry objecten in de navigatiegeschiedenis achterhalen door de NavigationWindow.BackStack of Frame.BackStack eigenschappen te inventariseren. Voor de geschiedenis van de navigatie doorsturen kunt u alle JournalEntry objecten ophalen door de NavigationWindow.ForwardStack of Frame.ForwardStack eigenschappen op te sommen.

Als u het meest recente JournalEntry object uit de backnavigatiegeschiedenis wilt verwijderen, kunt u bijvoorbeeld de RemoveBackEntry methode aanroepen (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), waarmee het JournalEntry object wordt verwijderd en een verwijzing naar het object wordt geretourneerd.

U kunt echter geen objecten toevoegen JournalEntry aan de navigatiegeschiedenis, omdat u geen instantie kunt maken of afleiden van JournalEntry, en omdat er geen type een lid implementeert om dit te doen. U kunt echter aangepaste CustomContentState objecten toevoegen aan de navigatiegeschiedenis door de AddBackEntry methode (AddBackEntry, , AddBackEntryAddBackEntry); NavigationService het CustomContentState object aan te roepen aan een intern gemaakt JournalEntry object, dat vervolgens wordt toegevoegd aan de backnavigatiegeschiedenis.