Installation
tasqize SDK can be installed through multiple methods, each tailored to different development environments and preferences. Below are the recommended ways to install tasqize:
1. NuGet (Preferred Method)
NuGet is the most straightforward and preferred method for installing tasqize, ensuring that you always have the latest version and updates directly within your development environment. Check more details about this installation method at How to install tasqize SDKs using NuGet.
2. MSI Installer
The MSI installer is a convenient option if you prefer to have the tasqize DLLs installed directly onto your system. This method is ideal for developers who may want to use tasqize across multiple projects without needing to manually manage DLL files. Check more details about this installation method at How to install tasqize SDKs using MSI.
3. ZIP Archive
For developers who prefer a manual approach, the ZIP archive contains the tasqize DLLs, which can be extracted and added to your project directly. Check more details about this installation method at How to install tasqize SDKs using ZIP.
Subsections of Installation
System Requirements
tasqize SDKs are designed to integrate with .NET applications and support various operating systems and development environments. Below are the key system requirements:
Supported Operating Systems
Windows
- Windows 7 (x64, x86)
- Windows 8, 8.1 (x64, x86)
- Windows 10 (x64, x86)
- Windows 11 (x64, x86)
- Windows Server 2003 to Windows Server 2022 (x64, x86)
- Cloud: Microsoft Azure
macOS
- macOS 10.12 (Sierra) and later
Linux
- Compatible with multiple Linux distributions:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)
Android
- Supports Android 8.0 (Oreo) and later.
Development Environments
- Microsoft Visual Studio:
- Visual Studio 2010 and later (including 2019 and 2022)
- Supports any development environment targeting .NET platforms.
Supported .NET Frameworks
- .NET Framework 4.0 and higher
- .NET Standard 2.0 (.NET Core 3.1+)
- .NET 6.0, .NET 7.0, .NET 8.0
Additional Notes
- Adobe Acrobat is not required to run tasqize SDKs, but is recommended for viewing PDFs.
Declaration
tasqize.com SDKs require a Full Trust permission set when used within .NET applications. This permission level is essential for the SDKs to perform certain system-level operations, such as accessing registry settings, system files, and parsing fonts.
Why Full Trust is Required
The tasqize SDKs utilize core .NET system classes, which often need elevated permissions for the following reasons:
- Registry Access: Some operations may require reading or writing to the system registry.
- System Files: Access to system files beyond the application’s virtual directory may be necessary for certain tasks, such as handling fonts or performing file operations.
Limitations of Medium Trust Environment
In hosting environments that enforce Medium Trust security, several important permissions are restricted or unavailable. This could prevent the SDKs from functioning correctly in such environments. The following restrictions apply under Medium Trust:
- OleDbPermission: Cannot use the ADO.NET managed OLE DB data provider to access databases.
- EventLogPermission: Access to the Windows Event Log is prohibited.
- ReflectionPermission: Prevents the use of reflection, which may affect certain dynamic operations.
- RegistryPermission: Access to the system registry is denied.
- WebPermission: Communication is restricted to predefined addresses or ranges as configured in the
<trust>
element. - FileIOPermission: Access to files is limited to those within the application’s virtual directory.
Non-Windows Environment
tasqize SDKs support .NET Standard 2.0, which allows them to be used in .NET Core applications running on Linux or other non-Windows environments. To ensure optimal performance and correct text rendering, follow the steps below:
Recommended Setup for Linux
1. Install libgdiplus Package
This package provides necessary GDI+ functionality, which is critical for rendering and processing PDFs. You can install it by running the following command in your terminal:
sudo apt-get install libgdiplus
2. Install Microsoft Compatible Fonts
For correct text rendering, install Microsoft TrueType fonts using the command:
sudo apt-get install ttf-mscorefonts-installer
These fonts should be placed in the /usr/share/fonts/truetype/msttcorefonts
directory. If your system stores fonts in a different directory, update the path in your code before performing any operations with tasqize SDKs:
tasqize.Text.FontRepository.Sources.Add(new FolderFontSource("<path to ms fonts>"));
Tip
By ensuring these installations are complete and configuring the font path correctly, you can maximize the performance of tasqize SDKs on Linux or other non-Windows systems.
Evaluation
You can easily download the tasqize SDKs for evaluation purposes. The evaluation version is identical to the purchased version, with the only difference being how you apply the license.
Evaluation Version Limitations
While the evaluation version provides full access to all features, it includes the following limitations until a license is applied:
- An evaluation watermark is inserted into all output documents.
- Only the first four pages of any PDF document can be viewed or edited.
To remove these limitations and unlock the full version, simply apply a license by adding a few lines of code to your project.
FAQs
This FAQ provides comprehensive information regarding the features and functionalities of tasqize .NET Plugins, covering aspects like PDF conversion, form handling, and table of contents (TOC) generation.
General Questions
1. What is tasqize for .NET?
tasqize for .NET is a powerful library for managing and processing PDF documents programmatically. It includes plugins for converting PDFs into various formats, editing PDF forms, adding digital signatures, generating TOCs, and ensuring PDF/A compliance for long-term archival.
2. How do I install tasqize plugins for .NET?
You can install the tasqize plugins by downloading assembly files from the official website or fetching packages directly from NuGet. Detailed installation instructions are available within each plugin’s documentation.
PDF Conversion Plugins
3. How can I convert a PDF document to a Word (DOC/DOCX) file?
To convert a PDF document into Word format using the PDF to DOC Converter:
- Instantiate the
PdfDoc
class. - Create a
PdfToDocOptions
object to configure conversion options. - Add input PDF and output DOC/DOCX file paths.
- Call the
Process
method to execute the conversion.
4. How do I convert PDF pages into JPEG images?
Using the PDF to JPEG Converter:
- Create an instance of the
Jpeg
class. - Set conversion options (e.g., resolution, page range) via
JpegOptions
. - Add input/output file paths.
- Call the
Jpeg.Process
method to run the conversion.
5. How do I convert a PDF to PNG?
To convert a PDF into PNG format:
- Create an instance of the
Png
class and a PngOptions
object. - Add the input PDF and specify the output folder.
- Set options such as resolution (e.g., 300 DPI).
- Call the
Process
method to generate PNG images.
6. How do I convert a PDF to Excel (XLS/XLSX)?
For converting PDF to Excel:
- Instantiate the
PdfXls
class. - Use
PdfToXlsOptions
to configure input/output paths and conversion options. - Call the
Process
method to start the conversion.
7. How do I convert a PDF to HTML?
To convert PDF documents into HTML:
- Create an instance of the
PdfHtml
class. - Configure conversion options with
PdfToHtmlOptions
or HtmlToPdfOptions
. - Add input/output paths and call the
Process
method.
The PDF Form Editor provides capabilities to:
- Add fields (
FormEditorAddOptions
). - Update fields (
FormEditorSetOptions
). - Remove fields (
FormRemoveSelectedFieldsOptions
).
After configuring the form fields, run the Process
method.
To flatten form fields:
- Instantiate the
FormFlattener
class. - Use
FormFlattenAllFieldsOptions
to flatten all fields or FormFlattenSelectedFieldsOptions
to target specific fields. - Add input/output files and call the
Process
method.
To export form data, use the PDF Form Exporter. Create a FormExporterValuesToCsvOptions
object, specify form field conditions, and run the Process
method to export the data into CSV format.
PDF/A and TOC Management
For converting PDFs into PDF/A:
- Use the
PdfAConverter
class. - Configure the PDF/A version (e.g., PDF/A-3B) in
PdfAConvertOptions
. - Add input/output paths and call the
Process
method.
12. How do I generate a Table of Contents (TOC) in a PDF?
To create a TOC:
- Create an instance of the
TocGenerator
class. - Use
TocOptions
to define TOC parameters. - Add input/output files and run the
Process
method.
Signature Handling
13. How can I digitally sign a PDF document?
To add a digital signature:
- Instantiate the
Signature
class. - Use
SignOptions
to configure the PFX file, password, and signature details (e.g., reason, contact info). - Add input/output files and run the
Process
method.
Additional Features
14. Can I split PDF files using tasqize?
Yes, using the PDF Splitter:
- Instantiate the
Splitter
class. - Configure split options using
SplitOptions
. - Add input/output paths and call the
Process
method.
15. How do I merge multiple PDF files into one?
To merge PDFs:
- Instantiate the
Merger
class. - Add input PDFs and specify an output file via
MergeOptions
. - Run the
Process
method to merge the files.
16. Is tasqize limited to working with PDFs only?
While tasqize primarily focuses on PDF manipulation, it also supports conversions to and from formats such as DOC, XLS, HTML, JPEG, and PNG.
Licensing and Compatibility
17. What are the system requirements for using tasqize plugins?
tasqize supports:
- Operating Systems: Windows 7-11, Windows Server 2003-2022, macOS (10.12+), and Linux.
- Frameworks: .NET Framework 4.0 to 8.0.
- IDE: Compatible with various versions of Visual Studio.
18. How do I set license keys for tasqize?
To activate a plugin, reference tasqize in your project and set the license keys before calling any methods. Refer to the specific plugin’s documentation for detailed instructions.
19. Where can I find more examples and documentation for tasqize plugins?
Complete API documentation and examples can be found on the tasqize website or through the NuGet packages within your development environment.