Click or drag to resize

PdfHttpHandlerWithReadOnlySession Class

Defines the contract that ASP.NET implements to synchronously process HTTP Web requests made by a PdfWebControl or PdfWebControlLite including read-only session information.
Inheritance Hierarchy
SystemObject
  RadPdf.Web.HttpHandlerPdfHttpHandlerWithoutSession
    RadPdf.Web.HttpHandlerPdfHttpHandlerWithReadOnlySession

Namespace:  RadPdf.Web.HttpHandler
Assembly:  RadPdf (in RadPdf.dll) Version: 3.48.0.0 (3.48.0.0)
Syntax
Copy
public class PdfHttpHandlerWithReadOnlySession : PdfHttpHandlerWithoutSession, 
	IReadOnlySessionState, IRequiresSessionState

The PdfHttpHandlerWithReadOnlySession type exposes the following members.

Constructors
  NameDescription
Public methodPdfHttpHandlerWithReadOnlySession
Initializes a new instance of the PdfHttpHandlerWithReadOnlySession class
Top
Properties
  NameDescription
Public propertyIsReusable
Gets a value indicating whether more than one request can use this HttpHander instance
(Inherited from PdfHttpHandlerWithoutSession.)
Top
Methods
  NameDescription
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodProcessRequest
Enables processing of HTTP Web requests by the HttpHandler.
(Inherited from PdfHttpHandlerWithoutSession.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Remarks

This class and its members should only be used in a web application setup for a PdfWebControl.

This class should be used instead of PdfHttpHandler when a custom PdfIntegrationProvider is being used which only reads ASP.NET session information only. If read and write access is needed to session information, consider using PdfHttpHandlerWithSession instead. If only no access is needed to session information, consider using PdfHttpHandlerWithoutSession instead.

If PdfHttpHandlerWithReadOnlySession is the designated handler, the UpdateSession(String, PdfLiteSession) method (and other UpdateSession(String, PdfLiteSession) implementations using the ASP.NET Session object) will fail (in some cases silently).

Session information can be accessed in a custom PdfIntegrationProvider using HttpContext.Current.Session (the namespace System.Web must be referenced).

Examples
The following sample web.config file registers the PdfHttpHandlerWithReadOnlySession for use in this web application which uses PdfWebControl.
XML
Copy
<?xml version="1.0"?>
<configuration>
  <appSettings>
    <add key="RadPdfConnectionString" value="Server=.\SQLExpress;Database=RadPdf;Trusted_Connection=Yes;"/>
    <add key="RadPdfLicenseKey" value="DEMO"/>
  </appSettings>
  <system.web>
    <httpHandlers>
      <add path="RadPdf.axd" verb="GET,POST" type="RadPdf.Web.HttpHandler.PdfHttpHandlerWithReadOnlySession"/>
    </httpHandlers>
  </system.web>
  <!--
    The system.webServer element is for use with IIS 7 (and later) when Managed Pipeline Mode is set to "Integrated".
    It will be ignored in other versions of IIS.
    -->
  <system.webServer>
    <validation validateIntegratedModeConfiguration="false"/>
    <handlers>
      <add path="RadPdf.axd" verb="GET,POST" name="PdfHttpHandler" preCondition="integratedMode" type="RadPdf.Web.HttpHandler.PdfHttpHandlerWithReadOnlySession"/>
    </handlers>
  </system.webServer>
</configuration>
See Also