NuGet Tutorial I - Web Document Viewer21 Jun 2016
Hi, Dmitry is here.
Today I want to start a series of simple but motivating posts about NuGet packages for DotImage product and how they can be useful to speed up development of imaging and capture-oriented applications.
We start with Web Document Viewer
So, let’s start with empty ASP.NET project:
We are going to stick with Empty ASP.NET template - we want to write some code, didn’t we?
Next step is to add a number of DotImage packages to the project. To do that, right-click on the project and select Manage NuGet Packages:
For the purposes of this tutorial we need to install two packages:
- Atalasoft DotImage WebContorls (32-bit) - server side code that supports Web Document Viewer. I’m using 32-bit package here, since IIS Express is 32-bit process. In real life you may want to choose 64-package.
During installation of these two packages a lot of stuff happens behind the scenes:
- NuGet infrastructure downloads .NET assemblies along with all dependencies, specified in package definition. All the assemblies are referenced automatically, so you don’t need to do it explicitly:
Once you have both packages installed, you are ready to add some code. The process is very similar to what is described in our Dev guide
- I will briefly cover it below.
We are going to start with adding Generic Handler to the project (right-click on the project and select Add -> New Item…) Enter WebDocViewerHandler as a name of the handler:
Replace generated code with the following:
We plan to show PDF files in our viewer, so let’s register PdfDecoder class to support PDF rendering on server side. For web applications, the most simple way to achieve this is to add Global.asax file with the following content:
The final thing we need to do on the server side, is to add some files for rendering. I created Documents folder in my web site structure and put a PDF there:
Now we have sever side ready, so we can move on and create a simple index.html web page (right-click on the project and select Add -> HTML Page). Below is HTML markup you can use to add and initialize Web Document Viewer / Thumbnailer:
That’s it! You just need to start you web site and in a moment you will see your PDF file and will be able to play with it using Web Document Viewer:
The steps I described here can be completed in 5-10 minutes even if you try to use Atalasoft toolkit for the first time. But you can achieve the same result even faster if you clone ready-to-go project from GitHub repository we created to hold our tutorial projects - all you need to do is to open the project in Visual Studio and run it - all necessary NuGet packages will be downloaded automatically during the build. If you are fast enough, it can be done in a minute (proof link is badly needed) :)
See you soon, happy coding!