PublishingCachablePage Class

Base class used for all page layouts and .aspx pages that use new performance enhancements in the Microsoft.SharePoint.Publishing namespace.

Inheritance Hierarchy

System.Object
  System.Web.UI.Control
    System.Web.UI.TemplateControl
      System.Web.UI.Page
        Microsoft.SharePoint.WebPartPages.WebPartPage
          Microsoft.SharePoint.Publishing.PublishingCachablePage
            Microsoft.SharePoint.Publishing.PublishingLayoutPage
            Microsoft.SharePoint.Publishing.TemplateRedirectionPage

Namespace:  Microsoft.SharePoint.Publishing
Assembly:  Microsoft.SharePoint.Publishing (in Microsoft.SharePoint.Publishing.dll)

Syntax

'Declaration
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public Class PublishingCachablePage _
    Inherits WebPartPage
'Usage
Dim instance As PublishingCachablePage
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public class PublishingCachablePage : WebPartPage

Remarks

This base class is used for all page layouts and .aspx pages that use the new performance enhancements in the Microsoft.SharePoint.Publishing namespace. Enhancements include the ability to use the full page output cache feature of ASP.NET 2.0 and the field control cache available in Microsoft.SharePoint.Publishing.

Additionally, Microsoft Office SharePoint Server 2007 enables caching functionality that is ordinarily prevented by Windows SharePoint Services. Because Office SharePoint Server 2007 relies on ASP.NET 2.0 caching, it instructs Windows SharePoint Services not to set HttpContext.Response.Cache. Specifically, Windows SharePoint Services disables the <% @ Output Cache> directive by resetting values in HttpContext.Response.Cache that would ordinarily prevent other applications from using ASP.NET 2.0 caching in a Windows SharePoint Services environment. Windows SharePoint Services is then able to use ASP.NET 2.0 output caching.

Windows SharePoint Services instructs ASP.NET 2.0 to get no more data than is necessary to support a caching operation.

To minimize latency and maximize page processing performance, Windows SharePoint Services sets the following properties to get only the amount of data that is required:

  • context.ListItemDisplayName

  • context.LineItemID

  • context.ListItemServerRelativeUrl

  • context.LoadContentTypes

  • context.FieldControlCacheGetCallback

  • context.FieldControlCacheSetCallback

Additional performance improvements have been made to reduce the overhead of initializing certain pieces of the SPContext object.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

PublishingCachablePage Members

Microsoft.SharePoint.Publishing Namespace