|
Under most circumstances you will want to install ABCpdf .NET using
the standard installer and register it using the PDFSettings control
panel.
Occasionally you may wish to install ABCpdf manually. To do this
you will need the files listed below.
| File Name |
Notes |
| ABCpdf.dll |
The Assembly used by .NET.
The installer places this Assembly in the GAC to allow global
access from any .NET application. It installs a second reference
copy at the following location:
C:\Program Files\WebSupergoo\ABCpdf6 .NET\Common\
However if you are installing manually you can just place
this file in the bin directory of your application.
|
| ABCpdfCE6.dll |
The ABCpdf core engine.
This DLL contains the core engine. It incorporates our proprietary
Direct to PDF technology and is designed for high performance
PDF manipulation in a multithreaded environment. This DLL
is placed into the system32 directory typically at:
C:\winnt\system32\
However if you are installing manually you can just place
this file in the bin directory of your application.
|
Most calls to ABCpdf will result in a trial license being created
and inserted if it is found that no such license has yet been inserted.
At minimum all that is required is to query the value of the XSettings.License
property.
[C#]
using WebSupergoo.ABCpdf6;
MessageBox.Show("New License: " + XSettings.License)
;
[Visual Basic]
Imports WebSupergoo.ABCpdf6
MessageBox.Show("New License: " + XSettings.License
)
The ABCpdf installer performs this type of check at installation
time in order to ensure that a trial license is inserted. However
inserting a license at other times can be problematic if your code
is operating from a reduced permission account such as that associated
with ASP.NET.
To enter a full license key create a simple .NET application containing
the following code. You will need write access to the registry to
install a license key.
[C#]
using WebSupergoo.ABCpdf6;
XSettings.License = "change this text to your key";
MessageBox.Show("New License: " + XSettings.License)
;
[Visual Basic]
Imports WebSupergoo.ABCpdf6
XSettings.License = "change this text to your key"
MessageBox.Show("New License: " + XSettings.License
)
Alternatively you may wish to install a license from within your
Doc object. You do not require write access to the registry when
using this method but the license which is installed is only temporary.
It is available until the process unloads. This can be useful for
installing on shared servers.
You can use a full license key as provided to you when you purchase
or you can use a trial license key copied from the PDFSettings application.
To insert your license use the SetInfo method immediately after
creating a Doc object.
[C#]
using WebSupergoo.ABCpdf6;
Doc theDoc = new Doc();
// here we use a trial license key as copied from the PDFSettings
application
theDoc.SetInfo(0, "License", "cd9b5c07db69df2bf57c0a04d9bca58b10c44889c9fb197984e592f49addfce5ec5fe85d7b9205bc");
Response.Write(theDoc.GetInfo(0, "License"))
;
[Visual Basic]
Imports WebSupergoo.ABCpdf6
Dim theDoc As Doc = New Doc()
' here we use a trial license key as copied from the PDFSettings
application
theDoc.SetInfo 0, "License", "cd9b5c07db69df2bf57c0a04d9bca58b10c44889c9fb197984e592f49addfce5ec5fe85d7b9205bc"
Response.Write(theDoc.GetInfo(0, "License")
)
|
Shared Hosts. Most installations of ABCpdf .NET on
shared servers are seamless. However you need to be aware
that you are a guest on the server and your host may have
locked down permissions in ways which will make your life
difficult. If this occurs there is typically little that either
you or us can do about it.
This is why we recommend deployment on a dedicated server.
Dedicated servers are cheaper than you might think and the
level of control they allow is only one of the very significant
advantages they afford. It is one of the best decisions you
can make.
If you are intending to install on a shared server the essential
thing to do is to deploy early and discover any issues before
they become major problems.
|
|
