JournalEntry Classe

Definição

Representa uma entrada no histórico de navegação, para frente ou para trás.Represents an entry in either back or forward navigation history.

public ref class JournalEntry : System::Windows::DependencyObject, System::Runtime::Serialization::ISerializable
[System.Serializable]
public class JournalEntry : System.Windows.DependencyObject, System.Runtime.Serialization.ISerializable
type JournalEntry = class
    inherit DependencyObject
    interface ISerializable
Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable
Herança
Atributos
Implementações

Exemplos

O exemplo a seguir mostra como recuperar o objeto JournalEntry mais recente da pilha de navegação voltar para obter os valores de propriedade Name e Source.The following example shows how to retrieve the most recent JournalEntry object from the back navigation stack to get the Name and Source property values.

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

Comentários

Windows Presentation Foundation implementa um serviço de histórico de navegação que armazena uma entrada para cada parte do conteúdo que foi previamente navegado, assim como o histórico de navegação em Microsoft Internet ExplorerMicrosoft Internet Explorer.Windows Presentation Foundation implements a navigation history service that stores one entry for each piece of content that has been previously navigated to, just like navigation history in Microsoft Internet ExplorerMicrosoft Internet Explorer. O histórico de navegação inclui duas pilhas, uma que retorne o histórico de navegação de volta e outra que remembere o histórico de navegação de encaminhamento.Navigation history comprises two stacks, one that remembers back navigation history, and one that remembers forward navigation history.

Uma entrada para o item atual é adicionada ao histórico de navegação de volta quando ocorre uma navegação progressiva.An entry for the current item is added to back navigation history when a forward navigation occurs. Isso ocorre nas seguintes situações:This occurs in the following situations:

Da mesma forma, uma entrada para o item atual é adicionada para encaminhar o histórico de navegação antes que ocorra uma navegação regressiva, o que acontece quando:Likewise, an entry for the current item is added to forward navigation history before a back navigation occurs, which happens when:

Cada entrada no histórico de navegação voltar e avançar é uma instância da classe JournalEntry.Each entry in back and forward navigation history is an instance of the JournalEntry class.

Cada objeto de JournalEntry encapsula informações sobre uma navegação específica, incluindo um nome para a entrada (Name), se a entrada é mantida ativa (KeepAlive) e o URI (Uniform Resource Identifier) para o conteúdo que é navegado (Source).Each JournalEntry object encapsulates information about a particular navigation, including a name for the entry (Name), whether the entry is kept alive (KeepAlive) and the uniform resource identifier (URI) for the content that is navigated to (Source).

Você pode recuperar todos os objetos de JournalEntry no histórico de navegação de volta enumerando as propriedades NavigationWindow.BackStack ou Frame.BackStack.You can retrieve all the JournalEntry objects in back navigation history by enumerating the NavigationWindow.BackStack or Frame.BackStack properties. Para o histórico de navegação progressiva, você pode recuperar todos os objetos de JournalEntry enumerando as propriedades NavigationWindow.ForwardStack ou Frame.ForwardStack.For forward navigation history, you can retrieve all the JournalEntry objects by enumerating the NavigationWindow.ForwardStack or Frame.ForwardStack properties.

Se você precisar remover o objeto JournalEntry mais recente do histórico de navegação de volta, para evitar a navegação para ele, por exemplo, você pode chamar o método RemoveBackEntry (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), que remove o objeto JournalEntry e retorna uma referência a ele.If you need to remove the most recent JournalEntry object from back navigation history, to prevent navigation to it, for example, you can call the RemoveBackEntry method (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), which removes the JournalEntry object and returns a reference to it.

No entanto, não é possível adicionar JournalEntry objetos ao histórico de navegação, porque você não pode criar uma instância nem derivar de JournalEntrye, como nenhum tipo implementa um membro para fazer isso.You cannot add JournalEntry objects to navigation history, however, because you can neither instantiate nor derive from JournalEntry, and because no type implements a member to do so. No entanto, você pode adicionar objetos de CustomContentState personalizados ao histórico de navegação de volta chamando o método AddBackEntry (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService adiciona o objeto CustomContentState a um objeto JournalEntry criado internamente, que é então adicionado ao histórico de navegação voltar.However, you can add custom CustomContentState objects to back navigation history by calling the AddBackEntry method (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService adds the CustomContentState object to an internally-created JournalEntry object, which is then added to the back navigation history.

Construtores

JournalEntry(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe JournalEntry.Initializes a new instance of the JournalEntry class.

Campos

KeepAliveProperty

Identifica a propriedade KeepAlive anexada.Identifies the KeepAlive attached property.

NameProperty

Identifica a propriedade Name anexada.Identifies the Name attached property.

Propriedades

CustomContentState

Obtém ou define o objeto CustomContentState que é associado com essa entrada de diário.Gets or sets the CustomContentState object that is associated with this journal entry.

DependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLRCLR dessa instância.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Herdado de DependencyObject)
Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Herdado de DispatcherObject)
IsSealed

Obtém um valor que indica se essa instância está validada no momento (somente leitura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Herdado de DependencyObject)
Name

Obtém ou define o nome da entrada de diário.Gets or sets the name of the journal entry.

Source

Obtém ou define o URI do conteúdo para o qual foi navegado.Gets or sets the URI of the content that was navigated to.

Propriedades Anexadas

KeepAlive

Obtém ou define um valor que indica se o conteúdo de uma entrada de diário é mantido ou recriado quando acessado no histórico de navegação.Gets or sets a value that indicates whether the content of a journal entry is either retained or re-created when navigated to in navigation history.

Métodos

CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)
ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Herdado de DependencyObject)
CoerceValue(DependencyProperty)

Converte o valor da propriedade de dependência especificada.Coerces the value of the specified dependency property. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Herdado de DependencyObject)
Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Herdado de DependencyObject)
GetHashCode()

Obtém o código hash para esse DependencyObject.Gets a hash code for this DependencyObject.

(Herdado de DependencyObject)
GetKeepAlive(DependencyObject)

Retorna a propriedade anexada KeepAlive da entrada de diário para o elemento especificado.Returns the KeepAlive attached property of the journal entry for the specified element.

GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Herdado de DependencyObject)
GetName(DependencyObject)

Obtém a propriedade anexada Name da entrada de diário para o elemento especificado.Gets the Name attached property of the journal entry for the specified element.

GetObjectData(SerializationInfo, StreamingContext)

Chamado quando este objeto é serializado.Called when this object is serialized.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificada.Re-evaluates the effective value for the specified dependency property.

(Herdado de DependencyObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizada.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. A propriedade de dependência específica que mudou é relatada os dados do evento.The specific dependency property that changed is reported in the event data.

(Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, local, se houver.Returns the local value of a dependency property, if it exists.

(Herdado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.Sets the value of a dependency property without changing its value source.

(Herdado de DependencyObject)
SetKeepAlive(DependencyObject, Boolean)

Define a propriedade anexada KeepAlive do elemento especificado.Sets the KeepAlive attached property of the specified element.

SetName(DependencyObject, String)

Define a propriedade anexada Name do elemento especificado.Sets the Name attached property of the specified element.

SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

(Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Herdado de DependencyObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)

Aplica-se a