|
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:
%ProgramFiles%\WebSupergoo\ABCpdf7 .NET\Common\
However if you are installing manually you can just place this
file in the bin directory of your application.
|
| ABCpdfCE7.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:
%SystemRoot%\system32\
However if you are installing manually you can just place this
file in the bin directory of your application.
|
| PrintHook32.dll |
Intercepts Microsoft XPS Document Writer.
Enables ABCpdf to import an extended range of file types via
XPS. This DLL is normally located in the same directory as the core
engine. This DLL is required for 32-bit and 64-bit operating
systems.
|
| PrintHook64.dll |
Same as PrintHook32.dll, but for 64-bit operating systems.
This DLL is also located in the same directory as the core
engine. Please note that PrintHook32.dll is also requried for
32-bit processes under WOW64 on 64-bit operating systems.
|
| ABCImageMagick.msi |
This is an optional component.
ABCpdf supports the import of more image formats through the
separate ABCImageMagick COM+ Application, which is not
automatically installed and you can manually install with
ABCImageMagick.msi.
|
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.LicenseDescription property.
[C#]
using WebSupergoo.ABCpdf7;
MessageBox.Show("New License: " +
XSettings.LicenseDescription);
[Visual Basic]
Imports WebSupergoo.ABCpdf7
MessageBox.Show("New License: " +
XSettings.LicenseDescription)
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 enter a license key, call
XSettings.InstallSystemLicense at application startup before any
ABCpdf objects have been created.
[C#]
using WebSupergoo.ABCpdf7;
// here we use a trial license key as copied from the PDFSettings
application
if
(XSettings.InstallSystemLicense("cd9b5c07db69df2bf57c0a04d9bca58b10c44889c9fb197984e592f49addfce5ec5fe85d7b9205bc"))
MessageBox.Show("License Installed Successfully: " +
XSettings.LicenseDescription);
else
MessageBox.Show("License Installation
Failed");
[Visual Basic]
Imports WebSupergoo.ABCpdf7
' here we use a trial license key as copied from the PDFSettings
application
If
XSettings.InstallSystemLicense("cd9b5c07db69df2bf57c0a04d9bca58b10c44889c9fb197984e592f49addfce5ec5fe85d7b9205bc")
Then
MessageBox.Show("License Installed Successfully: " +
XSettings.LicenseDescription)
Else
MessageBox.Show("License Installation Failed")
End If
Alternatively, you can install a license from within your Doc
object.
[C#]
using WebSupergoo.ABCpdf7;
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.ABCpdf7
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"))
The ABCpdf installer performs checks 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.
If this is the case or if you have purchased a Redistribution
license, you need to call XSettings.InstallRedistributionLicense at
application startup before any ABCpdf objects have been created.
You only need to call this method once, though calling it
additional times will not cause problems. The license will remain
available to the process until it unloads.
[C#]
using WebSupergoo.ABCpdf7;
if (XSettings.InstallRedistributionLicense("change this text to
your key"))
MessageBox.Show("License Installed Successfully: " +
XSettings.LicenseDescription);
else
MessageBox.Show("License Installation
Failed");
[Visual Basic]
Imports WebSupergoo.ABCpdf7
If XSettings.InstallRedistributionLicense("change this text to your
key") Then
MessageBox.Show("License Installed Successfully: " +
XSettings.LicenseDescription)
Else
MessageBox.Show("License Installation Failed")
End If
|
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.
|
|
