Get Start With Windows ​

Requirements ​

• Visual Studio

  Make sure that the .NET Core cross-platform development workload and MSBUILD are part of your installation.

  This guide will use Visual Studio 2022. If you would like to use the NuGet integration for Windows x64 please make sure you have Visual Studio 2017 or later.

  Note: ComPDFKit PDF SDK is multi-targeting. Target Frameworks: .NET Core 2.1+, .NET Standard 2.0, .NET 5, .NET 6, .NET 7, .NET 8.

• ComPDFKit 's .NET Core PDF Library for Windows:

  Please contact us to get the ComPDFKit PDF SDK for .NET Core.

• ComPDFKit PDF SDK license

  Commercial license keys are required for use in production environments. If you do not have a valid license key, please contact us to obtain the license key.

  License keys are uniquely generated. Please make sure that it is not publicly available (e.g. in your public GitHub).

Run the Samples ​

1. Open the solution file 'Example. sln' in Visual Studio.
2. Select a sample project in Solution Explorer and set it as the startup project. CS and VB examples are currently available.
3. Build and run the example.

Or you can open the command line tool in the project folder and run the example through the command:

dotnet run

Integrate into Your Application ​

You can follow the manual or nuget integration described below. This section will help you build your first ComPDFKit application. If you can open, save, and close PDFDoc, you can easily integrate the rest of the ComPDFKit PDF SDK.

Integrate Manually ​

1. Open a new instance of Visual Studio 2022and create a new .NET Core console application project (File > New > Project... ). You can find this under the Visual C# menu.

Click on OK and allow the IDE to create the project.

1. Find the Solution Explorer on the right side of the screen. Select the project and press Alt + Enter. This will open the properties tab.

Alternatively, you can right click on the project and find the properties option.

Select .NET Core 2.1 (or above) as the target framework for your application.

If you are using a Windows x64 machine for your .NET Core development, you can use NuGet package manager to get the ComPDFKit PDF SDK. Otherwise, please integrate the SDK manually.

1. Right-click "Dependencies" and click "Add Project Reference", which will open the "Reference Manager" dialog box. Click the option at the bottom of the dialog box, find the corresponding "ComPDFKit.NET.dll", select it and click Add.

1. In the Solution Explorer, select the project and press Shift + Alt + A. With this you can Add an Existing Item.

Alternatively, you can right click on the project and find the Add an existing item... option under the Add submenu.

Navigate to the library location again, select the file type as All Files (*.*) and select ComPDFKitNative.dll. Click Add.

5. Select ComPDFKit.NET.dll in the solution explorer. A properties window should appear below. In it, change the Build Action setting to Content and the Copy to Output Directory setting to Copy always. To avoid errors, use the drop-down menus available for those fields.

Integrate with NuGet ​

1. Perform the first 2 steps of integrating manually.

2. Right click on project Dependencies and click on Manage NuGet Packages.... This will open the NuGet Package Manager

3. Click on the Browse tab near the top of the package manager. In the search bar enter:

   ComPDFKit.NetCore

   1
   

4. Select the ComPDFKit.NetCore package by PDF Tecnologies Inc. and click on the Install button in the panel with the package information. If you're prompted or an external dialog is opened for confirmation, click on Ok.

   After installation, you will see the reference to the package under Dependencies in Solution Explorer.

Create PDF Document ​

We have completed all the preparation steps. Now let's use the ComPDFKit PDF SDK to create a PDF file with a blank page, and replace your Program. cs file with the following code. Note that you need to replace your license in the 'LicenseVerify()' method.

using ComPDFKit.NativeMethod;
using ComPDFKit.PDFDocument;
using Microsoft.Win32;
using System.Reflection.Metadata;
using System.Windows;

namespace ComPDFKit_Demo
{
    public class Program
    {
        private static bool LicenseVerify()
        {
            if (!CPDFSDKVerifier.LoadNativeLibrary())
                return false;
            LicenseErrorCode verifyResult = CPDFSDKVerifier.LicenseVerify("Input your license here");
            return (verifyResult == LicenseErrorCode.E_LICENSE_SUCCESS);
        }
        
        public static void Main()
        { 
            LicenseVerify();
            CPDFDocument document = CPDFDocument.CreateDocument();
             // Insert to the first page
			int pageIndex = 0;
			int pageWidth = 595;
			int pageHeight = 842;
			//The InsertPage method can specify an image path. When the image path is empty, a blank page will be inserted.
			document.InsertPage(pageIndex, pageWidth, pageHeight, "");
			document.WriteToFilePath("new_file.pdf");// Save the entire document object to the current path.
            Console.WriteLine("Done. Results saved in new_file.pdf");
        }
    }
}

After running the program, please check the output file generated by the program. You will find that a PDF file with blank pages has been generated, and by default, it should be in the bin/Debug directory where your project files are located.