Try our conversational search powered by Generative AI!

Class PageStoreBase

The base class that defines the events for page providers / DataFactory.

Inheritance
System.Object
PageStoreBase
Implements
System.IDisposable
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: EPiServer.Core
Assembly: EPiServer.Cms.AspNet.dll
Version: 11.20.7
Syntax
public class PageStoreBase : IContentEvents, IDisposable

Constructors

PageStoreBase()

Default constructor.

Declaration
public PageStoreBase()
Remarks

This is only meant to be used in test scenarios.

Methods

CreateSaveEventArgs(IContent, SaveAction, AccessLevel)

Creates an instance of SavePageEventArgs.

Declaration
protected SaveContentEventArgs CreateSaveEventArgs(IContent content, SaveAction action, AccessLevel access)
Parameters
Type Name Description
IContent content

The content to save.

SaveAction action

The requested save action.

AccessLevel access

The required access level.

Returns
Type Description
SaveContentEventArgs

A fully initialized SavePageEventArgs instance.

Dispose()

Implemenation of System.IDisposable

Declaration
public void Dispose()

Dispose(Boolean)

Actual implementation of Dispose.

Declaration
protected virtual void Dispose(bool disposing)
Parameters
Type Name Description
System.Boolean disposing

RaiseCancellableDeleteEvent(String, String, DeleteContentEventArgs)

Raises a cancellable delete event.

Declaration
protected void RaiseCancellableDeleteEvent(string key, string defaultReason, DeleteContentEventArgs eventArgs)
Parameters
Type Name Description
System.String key

The event identifier.

System.String defaultReason

The default cancel reason.

DeleteContentEventArgs eventArgs

The DeleteContentEventArgs instance containing the event data.

Remarks

If the events is cancelled a EPiServerCancelException is thrown. Unless the cancelling handler sets the CancelReason of PageEventArgs, the defaultReason is used as exception message.

RaiseCancellablePageEvent(String, String, ContentEventArgs)

Raises a cancellable page event.

Declaration
protected void RaiseCancellablePageEvent(string key, string defaultReason, ContentEventArgs eventArgs)
Parameters
Type Name Description
System.String key

The event identifier.

System.String defaultReason

The default cancel reason.

ContentEventArgs eventArgs

The PageEventArgs instance containing the event data.

Remarks

If the events is cancelled a EPiServerCancelException is thrown. Unless the cancelling handler sets the CancelReason of PageEventArgs, the defaultReason is used as exception message.

RaiseChildrenEvent(String, ChildrenEventArgs)

Raises a page children event.

Declaration
protected bool RaiseChildrenEvent(string key, ChildrenEventArgs eventArgs)
Parameters
Type Name Description
System.String key

The event identifier.

ChildrenEventArgs eventArgs

The ChildrenEventArgs instance containing the event data.

Returns
Type Description
System.Boolean

True if the event did not cancel.

RaiseDeleteEvent(String, DeleteContentEventArgs)

Raises the specified delete event.

Declaration
protected bool RaiseDeleteEvent(string key, DeleteContentEventArgs eventArgs)
Parameters
Type Name Description
System.String key

The event identifier.

DeleteContentEventArgs eventArgs

The DeleteContentEventArgs instance containing the event data.

Returns
Type Description
System.Boolean

True if the event did not cancel.

RaisePageEvent(String, ContentEventArgs)

Raises the specified page event.

Declaration
protected bool RaisePageEvent(string key, ContentEventArgs eventArgs)
Parameters
Type Name Description
System.String key

The event identifier.

ContentEventArgs eventArgs

The ContentEventArgs instance containing the event data.

Returns
Type Description
System.Boolean

True if the event did not cancel.

Events

CheckedInContent

Occurs when a version of a content item has been checked in.

Declaration
public event EventHandler<ContentEventArgs> CheckedInContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavedContent event.

CheckedOutContent

Occurs when a version of a content item has been checked out.

Declaration
public event EventHandler<ContentEventArgs> CheckedOutContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

CheckingInContent

Occurs when a version of a content item is about to be checked in.

Declaration
public event EventHandler<ContentEventArgs> CheckingInContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

CheckingOutContent

Occurs when a version of a content item is about to be checked out.

Declaration
public event EventHandler<ContentEventArgs> CheckingOutContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

CreatedContent

Occurs when a new content item has been saved to the repository.

Declaration
public event EventHandler<ContentEventArgs> CreatedContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised before the SavedContent event and a status specific event such as PublishedContent or CheckedInContent.

CreatedContentLanguage

Occurs when a new language branch of a content item has been created.

Declaration
public event EventHandler<ContentEventArgs> CreatedContentLanguage
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised before the SavedContent event and a status specific event such as PublishedContent or CheckedInContent.

CreatingContent

Occurs when a new content item is about to be saved to the repository.

Declaration
public event EventHandler<ContentEventArgs> CreatingContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised before the SavingContent event and a status specific event such as PublishingContent or CheckingInContent.

CreatingContentLanguage

Occurs when a new language branch of a content item is about to be created.

Declaration
public event EventHandler<ContentEventArgs> CreatingContentLanguage
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised before the SavingContent event and a status specific event such as PublishingContent or CheckingInContent.

DeletedContent

Occurs when a content item has been deleted from the wastebasket.

Declaration
public event EventHandler<DeleteContentEventArgs> DeletedContent
Event Type
Type Description
System.EventHandler<DeleteContentEventArgs>
Remarks

Note that this event is not raised when a content item is moved to the wastebasket. At that point only the MovedContent event is raised.

DeletedContentLanguage

Occurs when a language branch of a content item has been deleted.

Declaration
public event EventHandler<ContentEventArgs> DeletedContentLanguage
Event Type
Type Description
System.EventHandler<ContentEventArgs>

DeletedContentVersion

Occurs when a content item version has been deleted.

Declaration
public event EventHandler<ContentEventArgs> DeletedContentVersion
Event Type
Type Description
System.EventHandler<ContentEventArgs>

DeletingContent

Occurs when a content item is about to be deleted permanently.

Declaration
public event EventHandler<DeleteContentEventArgs> DeletingContent
Event Type
Type Description
System.EventHandler<DeleteContentEventArgs>
Remarks

Note that this event is not raised when a content item is about to be moved to the wastebasket. At that point only the MovingContent event is raised.

DeletingContentLanguage

Occurs when a language branch of a content item is about to be deleted.

Declaration
public event EventHandler<ContentEventArgs> DeletingContentLanguage
Event Type
Type Description
System.EventHandler<ContentEventArgs>

DeletingContentVersion

Occurs when a content item version is about to be deleted permanently.

Declaration
public event EventHandler<ContentEventArgs> DeletingContentVersion
Event Type
Type Description
System.EventHandler<ContentEventArgs>

FailedLoadingChildren

Occurs when a page list failed for some reason.

Declaration
public event ChildrenEventHandler FailedLoadingChildren
Event Type
Type Description
ChildrenEventHandler
Remarks

This event is generated if a LoadingChildrem is NOT followed by a LoadedChildren, i e FailedLoadingChildren is called instead of LoadedChildren. This is typically used if you need to clean up something that was initiated by LoadingChildren.

FailedLoadingContent

Occurs when an exception was raised while a content item was loaded from the repository.

Declaration
public event EventHandler<ContentEventArgs> FailedLoadingContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event is raised if a LoadingContent is NOT followed by a LoadedContent, i e FailedLoadingContent is called instead of LoadedContent. This is typically used if you need to clean up something that was initiated by LoadingContent.

FinishedLoadingChildren

Occurs when a list has been loaded from GetChildren

Declaration
public event ChildrenEventHandler FinishedLoadingChildren
Event Type
Type Description
ChildrenEventHandler
Remarks

This event is triggered after loading dynamic and personalized data.

LoadedChildren

Occurs when a list has been loaded from GetChildren

Declaration
public event ChildrenEventHandler LoadedChildren
Event Type
Type Description
ChildrenEventHandler
Remarks

This event is triggered before loading dynamic and personalized data.

LoadedContent

Occurs when a content item has been loaded from the repository.

Declaration
public event EventHandler<ContentEventArgs> LoadedContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>

LoadedDefaultContent

Occurs when a new content item has been created and initalized through the GetDefaultContent method.

Declaration
public event EventHandler<ContentEventArgs> LoadedDefaultContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>

LoadingChildren

Occurs when a list is requested from GetChildren

Declaration
public event ChildrenEventHandler LoadingChildren
Event Type
Type Description
ChildrenEventHandler

LoadingContent

Occurs when a content item are about to be loaded from the repository.

Declaration
public event EventHandler<ContentEventArgs> LoadingContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>

LoadingDefaultContent

Occurs when a new content item is about to be created and initalized through the GetDefaultContent method.

Declaration
public event EventHandler<ContentEventArgs> LoadingDefaultContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>

MovedContent

Occurs when a content item has been moved from one location to another.

Declaration
public event EventHandler<ContentEventArgs> MovedContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

Note that this event is also raised when a content item is moved to the wastebasket.

MovingContent

Occurs when a content item is about to be moved from one location to another.

Declaration
public event EventHandler<ContentEventArgs> MovingContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

Note that this event is also raised when a content item is about to be moved to the wastebasket.

PublishedContent

Occurs when a content item or a version of a content item has been published.

Declaration
public event EventHandler<ContentEventArgs> PublishedContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavedContent event.

PublishingContent

Occurs when a content item or a version of a content item is requested to be published.

Declaration
public event EventHandler<ContentEventArgs> PublishingContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

RejectedContent

Occurs when a version of a content item has been rejected.

Declaration
public event EventHandler<ContentEventArgs> RejectedContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

RejectingContent

Occurs when a version of a content item is about to be rejected.

Declaration
public event EventHandler<ContentEventArgs> RejectingContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

RequestedApproval

NOTE: This is a pre-release API that is UNSTABLE and might not satisfy the compatibility requirements as denoted by its associated normal version. Occurs when a version of a content item has been transitioned to AwaitingApproval state.

Declaration
public event EventHandler<ContentEventArgs> RequestedApproval
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

RequestingApproval

NOTE: This is a pre-release API that is UNSTABLE and might not satisfy the compatibility requirements as denoted by its associated normal version. Occurs when a version of a content item is about to be put in AwaitingApproval state.

Declaration
public event EventHandler<ContentEventArgs> RequestingApproval
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

SavedContent

Occurs when an existing content item has been saved to the repository.

Declaration
public event EventHandler<ContentEventArgs> SavedContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised in along with a status specific event such as PublishedContent, RejectedContent or ScheduledContent.

SavingContent

Occurs when an existing content item is about to be saved to the repository.

Declaration
public event EventHandler<ContentEventArgs> SavingContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised in along with a status specific event such as PublishingContent, RejectingContent or SchedulingContent.

ScheduledContent

Occurs when a version of a content item has been scheduled to be published.

Declaration
public event EventHandler<ContentEventArgs> ScheduledContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

SchedulingContent

Occurs when a version of a content item is about to be scheduled to be published.

Declaration
public event EventHandler<ContentEventArgs> SchedulingContent
Event Type
Type Description
System.EventHandler<ContentEventArgs>
Remarks

This event will be raised after the SavingContent event.

Implements

System.IDisposable

Extension Methods