CustomContentState Klass

Definition

public ref class CustomContentState abstract

[System.Serializable]
public abstract class CustomContentState

[<System.Serializable>]
type CustomContentState = class

Public MustInherit Class CustomContentState

Arv

Object

CustomContentState

Attribut

SerializableAttribute

Exempel

Följande är ett exempel på en CustomContentState implementering som åsidosätter JournalEntryName.

using System;
using System.Windows.Controls;
using System.Windows.Navigation;
[Serializable]
public class MyCustomContentState : CustomContentState
{
    string dateCreated;
    TextBlock dateTextBlock;

    public MyCustomContentState(string dateCreated, TextBlock dateTextBlock)
    {
        this.dateCreated = dateCreated;
        this.dateTextBlock = dateTextBlock;
    }

    public override string JournalEntryName
    {
        get
        {
            return "Journal Entry " + this.dateCreated;
        }
    }

    public override void Replay(NavigationService navigationService, NavigationMode mode)
    {
        this.dateTextBlock.Text = this.dateCreated;
    }
}

Imports System.Windows.Controls
Imports System.Windows.Navigation
<Serializable>
Public Class MyCustomContentState
    Inherits CustomContentState
    Private dateCreated As String
    Private dateTextBlock As TextBlock

    Public Sub New(ByVal dateCreated As String, ByVal dateTextBlock As TextBlock)
        Me.dateCreated = dateCreated
        Me.dateTextBlock = dateTextBlock
    End Sub

    Public Overrides ReadOnly Property JournalEntryName() As String
        Get
            Return "Journal Entry " & Me.dateCreated
        End Get
    End Property

    Public Overrides Sub Replay(ByVal navigationService As NavigationService, ByVal mode As NavigationMode)
        Me.dateTextBlock.Text = Me.dateCreated
    End Sub
End Class

Kommentarer

Som standard NavigationService lagrar inte en instans av ett innehållsobjekt i navigeringshistoriken. NavigationService Skapar i stället en ny instans av innehållsobjektet varje gång det navigeras till med hjälp av navigeringshistorik. Det här beteendet är utformat för att undvika överdriven minnesförbrukning när stora mängder och stora delar av innehållet navigeras till. Det innebär att innehållets tillstånd inte kommer ihåg från en navigering till en annan. Men WPF ger möjlighet att associera ett anpassat tillstånd med navigeringshistorikposten för ett innehåll.

Anpassat tillstånd som är associerat med en navigeringshistorikpost måste vara en klass som härleds från CustomContentState. Du associerar ett CustomContentState objekt med en navigeringshistorikpost med hjälp av någon av följande tekniker:

• Anropa AddBackEntry:

  • NavigationService.AddBackEntry

  • NavigationWindow.AddBackEntry

  • Frame.AddBackEntry.

• Ange NavigatingCancelEventArgs.Content när någon av följande händelser aktiveras:

  • NavigationService.Navigating

  • NavigationWindow.Navigating

  • Frame.Navigating

  • NavigationWindow.Navigating

• Genom att implementera IProvideCustomContentState den klass som vill att anpassat tillstånd ska associeras med den.

När navigeringshistorikposten navigeras till kontrollerar WPF om ett anpassat CustomContentState objekt är associerat med det. I så fall anropas Replay det för att tillåta att det anpassade CustomContentState objektet tillämpar det tillstånd som det kom ihåg från föregående navigering.

En anpassad CustomContentState klass kan åsidosätta JournalEntryName för att ändra namnet som visas för navigeringshistorikposten som CustomContentState objektet är associerat med. Värdet som JournalEntryName returneras visas från navigeringsgränssnittet för de olika navigatörerna (webbläsare, NavigationWindoweller Frame).

En klass som härleds från CustomContentState måste vara serialiserbar, vilket innebär att den åtminstone måste utökas med SerializableAttributeoch eventuellt implementera ISerializable.

Se även

• NavigationService
• JournalEntry