Click here to Skip to main content
15,868,164 members
Articles / Web Development / ASP.NET

ASP.NET PDF Viewer User Control Without Acrobat Reader Installed on Client or Server

Rate me:
Please Sign up or sign in to vote.
4.77/5 (72 votes)
19 Sep 2013GPL33 min read 917.3K   18.2K   365   330
ASP.NET PDF document viewer control that does not require any Acrobat product to be installed
PDFViewASP

Introduction

This article discusses how to create an ASP.NET PDF Viewer User Control that is not dependent on Acrobat software being installed.

Fundamental Concepts

  1. Get a page count of the PDF document that needs to be viewed to define your page number boundaries (PdfLibNet - XPDF) 
  2. Convert the PDF document (specific page on demand) to a raster image format (PdfLibNet - XPDF)  
  3. Convert the current page to be viewed into a PNG file
  4. Display the PNG file in an image on a web page 

Several utility classes were created or added from others which expose functionality needed from the various helper libraries.

  1. AFPDFLibUtil.vb (contains methods to create Bookmark HTML, Search, get page count, convert PDF to PNG)
  2. ImageUtil.vb (contains methods for image manipulation such as resize, rotation, conversion, etc.)
  3. ASPPDFLib.vb (contains generic wrapper functions that call specific technologies)
  4. PDFViewer.ascx.vb (contains code behind for the PDF Viewer User Control)
  5. PDFViewer.ascx (contains client side HTML/JavaScript for the PDF Viewer User Control)

Using the Code 

ASP Server Configuration Requirements

  • You must give the ASPNET user (IISUSR or ASPNET or Network services user) permission to modify (read/write) the /PDF and /render directories.
  • You must give the ASPNET user (IISUSR or ASPNET or Network services user) permission to  Read & Execute the /bin diirectory.
  • The DLL PDFLibNet.dll must be available to the page. You might have to register it with the GAC depending on your operating system to make it available to the application.
  • PDFLibNet.dll and PDFLibCmdLine.exe must both be compiled with the same architecture (x86 or x64) 
  • If x86 is used, you must set the advanced settings of the AppPool to allow execution of 32-bit applications if you are on a 64-bit OS.  

This project consists of 3 DLLs that must all be in the same directory:

  • PDFLibNET.dll
  • StatefullScrollPanel.dll
  • PDFViewASP.dll

To place a PDF Viewer User Control on a web page:   

ASP.NET
<uc1:PDFViewer ID="PDFViewer1" runat="server" /> 

Set the FileName property to view the PDF file in the code behind:

VB.NET
Dim pdfFileName As String = Request.MapPath("PDF") & "\" & "myPDF.pdf"
If ImageUtil.IsPDF(pdfFileName) Then
  ErrorLabel.Visible = False
  PDFViewer1.FileName = pdfFileName
Else
  ErrorLabel.Text = "Only PDF files (*.pdf) are allowed to be viewed."
  ErrorLabel.Visible = True
End If

The essential part of this solution is extracting the current page to be viewed from a PDF file. Since we are using ASP.NET, I chose to implement a file based solution to avoid memory management issues when trying to persist PDF byte streams for multiple clients. I chose to extract a page from PDF using PDFLibNet and store it to the File System as a PNG image. I chose PNG since it uses ZIP compression which results in a lossless compressed image and small file size.

VB.NET
  'Modified for ASP usage
  Public Shared Function GetPageFromPDF(ByVal filename As String, _
  ByVal destPath As String, ByRef PageNumber As Integer, _
  Optional ByVal DPI As Integer = RENDER_DPI, _
  Optional ByVal Password As String = "", _
  Optional ByVal searchText As String = "", _
  Optional ByVal searchDir As SearchDirection = 0) As String
  GetPageFromPDF = ""
  Dim pdfDoc As New PDFLibNet.PDFWrapper
  pdfDoc.RenderDPI = 72
  pdfDoc.LoadPDF(filename)
  If Not Nothing Is pdfDoc Then
    pdfDoc.CurrentPage = PageNumber
    pdfDoc.SearchCaseSensitive = False
    Dim searchResults As New List(Of PDFLibNet.PDFSearchResult)
    If searchText <> "" Then
      Dim lFound As Integer = 0
      If searchDir = SearchDirection.FromBeginning Then
        lFound = pdfDoc.FindFirst(searchText, _
          PDFLibNet.PDFSearchOrder.PDFSearchFromdBegin, False, False)
      ElseIf searchDir = SearchDirection.Forwards Then
        lFound = pdfDoc.FindFirst(searchText, _
          PDFLibNet.PDFSearchOrder.PDFSearchFromCurrent, False, False)
      ElseIf searchDir = SearchDirection.Backwards Then
        lFound = pdfDoc.FindFirst(searchText, _
          PDFLibNet.PDFSearchOrder.PDFSearchFromCurrent, True, False)
      End If
      If lFound > 0 Then
        If searchDir = SearchDirection.FromBeginning Then
          PageNumber = pdfDoc.SearchResults(0).Page
          searchResults = GetAllSearchResults(filename, searchText, PageNumber)
        ElseIf searchDir = SearchDirection.Forwards Then
          If pdfDoc.SearchResults(0).Page > PageNumber Then
            PageNumber = pdfDoc.SearchResults(0).Page
            searchResults = GetAllSearchResults(filename, searchText, PageNumber)
          Else
            searchResults = SearchForNextText(filename, searchText, _
                      PageNumber, searchDir)
            If searchResults.Count > 0 Then
              PageNumber = searchResults(0).Page
            End If
          End If
        ElseIf searchDir = SearchDirection.Backwards Then
          If pdfDoc.SearchResults(0).Page < PageNumber Then
            PageNumber = pdfDoc.SearchResults(0).Page
            searchResults = GetAllSearchResults(filename, searchText, PageNumber)
          Else
            searchResults = SearchForNextText(filename, searchText, _
                      PageNumber, searchDir)
            If searchResults.Count > 0 Then
              PageNumber = searchResults(0).Page
            End If
          End If
        End If
      End If
    End If
    Dim outGuid As Guid = Guid.NewGuid()
    Dim output As String = destPath & "\" & outGuid.ToString & ".png"
    Dim pdfPage As PDFLibNet.PDFPage = pdfDoc.Pages(PageNumber)
    Dim bmp As Bitmap = pdfPage.GetBitmap(DPI, True)
    bmp.Save(output, System.Drawing.Imaging.ImageFormat.Png)
    bmp.Dispose()
    GetPageFromPDF = output
    If searchResults.Count > 0 Then
      GetPageFromPDF = HighlightSearchCriteria(output, DPI, searchResults)
    End If
    pdfDoc.Dispose()
  End If
End Function

In the PDFViewer code, a page number is specified and:

  • The page is loaded from the PDF file and converted to a PNG file.
  • We add the PNG file name to the ASP.NET Cache with an expiration of 5 minutes to ensure that we don't leave rendered images lying around on the server.
  • The ImageUrl is updated with the path to the PNG file.

PDFViewer.ascx.vb

VB.NET
Private Sub DisplayCurrentPage(Optional ByVal doSearch As Boolean = False)
  'Set how long to wait before deleting the generated PNG file
  Dim expirationDate As DateTime = Now.AddMinutes(5)
  Dim noSlide As TimeSpan = System.Web.Caching.Cache.NoSlidingExpiration
  Dim callBack As New CacheItemRemovedCallback(AddressOf OnCacheRemove)
  ResizePanels()
  CheckPageBounds()
  UpdatePageLabel()
  InitBookmarks()
  Dim destPath As String = Request.MapPath("render")
  Dim indexNum As Integer = (parameterHash("CurrentPageNumber") - 1)
  Dim numRotation As Integer = parameterHash("RotationPage")(indexNum)
  Dim imageLocation As String
  If doSearch = False Then_
    imageLocation = ASPPDFLib.GetPageFromPDF(parameterHash("PDFFileName"), _
    destPath, parameterHash("CurrentPageNumber"), parameterHash("DPI"), _
    parameterHash("Password"), numRotation)
  Else
    imageLocation = ASPPDFLib.GetPageFromPDF(parameterHash("PDFFileName"), destPath _
                                             , parameterHash("CurrentPageNumber") _
                                             , parameterHash("DPI") _
                                             , parameterHash("Password") _
                                             , numRotation, parameterHash("SearchText") _
                                             , parameterHash("SearchDirection") _
                                             )
    UpdatePageLabel()
  End If
  ImageUtil.DeleteFile(parameterHash("CurrentImageFileName"))
  parameterHash("CurrentImageFileName") = imageLocation
  'Add full filename to the Cache with an expiration
  'When the expiration occurs, it will call OnCacheRemove which will delete the file
  Cache.Insert(New Guid().ToString & "_DeleteFile", imageLocation, _
   Nothing, expirationDate, noSlide, _
   System.Web.Caching.CacheItemPriority.Default, callBack)
  Dim matchString As String = _
   Request.MapPath("").Replace("\", "\\") ' escape backslashes
  CurrentPageImage.ImageUrl = Regex.Replace(imageLocation, matchString & "\\", "~/")
End Sub

Private Sub OnCacheRemove(ByVal key As String, ByVal val As Object, _
   ByVal reason As CacheItemRemovedReason)
  If Regex.IsMatch(key, "DeleteFile") Then
    ImageUtil.DeleteFile(val)
  End If
End Sub

ASPPDFLib.vb

VB.NET
  Public Shared Function GetPageFromPDF(ByVal sourceFileName As String _
                                      , ByVal destFolderPath As String _
                                      , ByRef iPageNumber As Integer _
                                      , Optional ByVal DPI As Integer = 0 _
                                      , Optional ByVal password As String = "" _
                                      , Optional ByVal rotations As Integer = 0 _
                                      , Optional ByVal searchText As String = "" _
                                      , Optional ByVal searchDir As Integer = _
                                          AFPDFLibUtil.SearchDirection.FromBeginning _
                                      ) As String
  GetPageFromPDF = AFPDFLibUtil.GetPageFromPDF(sourceFileName, _
  destFolderPath, iPageNumber, DPI, password, searchText, searchDir)
  ImageUtil.ApplyRotation(GetPageFromPDF, rotations)
End Function

Points of Interest

This project was made possible due to various open source libraries that others were kind enough to distribute freely. I would like to thank the PDFLibNet developer Antonio Sandoval and Foo Labs (XPDF) for their efforts.

History

  • 1.0 - Initial version
  • 1.1 - Added Search capabilities, reduced DLL dependencies, made PDF subsystem use XPDF only
  • 1.2 - Replaced PDFLibNet.dll to fix incorrect configuration error 0x800736B1
  • 1.3 - Optimized search routines
  • 1.4 - Remove outdated links to legacy content
  • 1.5 - Updated permissions information

License

This article, along with any associated source code and files, is licensed under The GNU General Public License (GPLv3)


Written By
Software Developer
United States United States
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionCan we add a Print Button Pin
red_dog6-Jun-13 20:27
red_dog6-Jun-13 20:27 
QuestionCan it have 'Continuos Display/Infinite Scrolling' feature/button in this viewer? Pin
Adam Chiam29-May-13 22:24
Adam Chiam29-May-13 22:24 
QuestionPossible To Make Display style as Scroll Down instead of click on Next button? Pin
Lim YK29-May-13 16:00
Lim YK29-May-13 16:00 
QuestionPDF not displaying Pin
akaii de shangaii23-May-13 18:04
akaii de shangaii23-May-13 18:04 
QuestionCan We Print this PDF Document with print dialog box Pin
PraveenGajawada21-Apr-13 21:23
PraveenGajawada21-Apr-13 21:23 
QuestionArabic Fonts Pin
mon8127-Jan-13 19:32
mon8127-Jan-13 19:32 
QuestionCan you help me to create pdf editor Pin
ADotNetDev19-Jan-13 2:40
ADotNetDev19-Jan-13 2:40 
AnswerRe: Can you help me to create pdf editor Pin
adriancs20-May-13 16:41
mvaadriancs20-May-13 16:41 
I don't think the author of this article will create a pdf editor for you.

However, I do suggest you to look for help at here: http://www.freelancer.com/[^].
There are lots of folks ready to do it for you..... of course, for a price.
QuestionC# code for this Pin
aravindnass1-Dec-12 18:24
aravindnass1-Dec-12 18:24 
Questionhow to download the code for this article Pin
vinaykd198121-Nov-12 1:08
vinaykd198121-Nov-12 1:08 
AnswerRe: how to download the code for this article Pin
zmmkele29-Nov-12 16:17
zmmkele29-Nov-12 16:17 
Questionprotected pdf Not working.... Pin
Gaurav12214-Nov-12 2:27
Gaurav12214-Nov-12 2:27 
AnswerRe: protected pdf Not working.... Pin
DadajiIn30-Nov-12 18:37
DadajiIn30-Nov-12 18:37 
QuestionHow to integrate this code in Asp.Net MVC ? Pin
Sachin Panchal30-Oct-12 23:55
Sachin Panchal30-Oct-12 23:55 
GeneralMy vote of 5 Pin
Savalia Manoj M29-Oct-12 1:39
Savalia Manoj M29-Oct-12 1:39 
Questionprotected pdf problem Pin
ivanruisoto23-Sep-12 23:36
ivanruisoto23-Sep-12 23:36 
QuestionForm Fields Pin
Mike Stiles14-Sep-12 11:53
Mike Stiles14-Sep-12 11:53 
GeneralMy vote of 5 Pin
Anurag Gandhi11-Sep-12 3:16
professionalAnurag Gandhi11-Sep-12 3:16 
QuestionC# version of PDF viewer Pin
ks.kumar10-Sep-12 22:18
professionalks.kumar10-Sep-12 22:18 
GeneralMy vote of 5 Pin
Farhan Ghumra10-Sep-12 19:30
professionalFarhan Ghumra10-Sep-12 19:30 
QuestionNot working with Online Server Database Pin
sanju ahuja9-Sep-12 7:48
sanju ahuja9-Sep-12 7:48 
QuestionPDF Viewer not working when impersonate = true Pin
pandiarajan198610-Aug-12 0:10
pandiarajan198610-Aug-12 0:10 
Questionpdf viewer Pin
slamet supriyadi2-Aug-12 20:18
slamet supriyadi2-Aug-12 20:18 
QuestionAttempted to read or write protected memory. This is often an indication that other memory is corrupt. Pin
rabbwhite24-Jul-12 22:52
rabbwhite24-Jul-12 22:52 
Questionpassword problem Pin
DonCreAtive20-Jul-12 3:46
DonCreAtive20-Jul-12 3:46 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.