←Select platform

PDFDocument Constructor(string,string)

Summary
Initializes a new PDFDocument form a specified PDF file and optional password.
Syntax
C#
C++/CLI
Java
Python
public PDFDocument( 
   string fileName, 
   string password 
) 
public PDFDocument( 
   java.lang.String fileName, 
   java.lang.String password 
); 
public: 
PDFDocument(  
   String^ fileName, 
   String^ password 
) 
__init__(self,fileName,password) # Overloaded constructor 

Parameters

fileName
The name of an existing PDF file.

password
The password to use if fileName contains an encrypted PDF file; otherwise, this parameter is not used.

Remarks

The PDFDocument class encapsulates a PDF document on disk and allows you to read the pages, objects and images from the document.

fileName must contain the name of an existing and valid PDF file on disk. If the PDF file is encrypted, then password is used to try to decrypt the file. If the password value is not correct, and exception will be thrown. Another way of loading PDF documents is to use the PDFDocument(string fileName) constructor. This constructor does not work on encrypted PDF files. Use the PDFFile.IsEncrypted to determine whether a PDF file is encrypted.

This method will initialize the members of PDFDocument as follows:

Use PDFDocument Constructor(Stream,String) to create a PDF document from a .NET stream.

Example

This example will determine whether a PDF file is encrypted. If it is, the user is asked for a password before the document is loaded.

C#
Java
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Controls; 
using Leadtools.Pdf; 
using Leadtools.Svg; 
using Leadtools.WinForms; 
 
 
public void PDFEncryptedExample() 
{ 
   string pdfFileName1 = Path.Combine(LEAD_VARS.ImagesDir, @"Leadtools.pdf"); 
   string pdfFileName2 = Path.Combine(LEAD_VARS.ImagesDir, @"Encrypted.pdf"); 
 
   // Create an encrypted version of Leadtools.pdf 
   PDFFile file = new PDFFile(pdfFileName1); 
   file.SecurityOptions = new PDFSecurityOptions(); 
   file.SecurityOptions.UserPassword = "LEAD"; 
   file.Convert(1, -1, pdfFileName2); 
 
   // Now try to open it as a document 
   string password = null; 
 
   if (PDFFile.IsEncrypted(pdfFileName2)) 
   { 
      Console.WriteLine("{0}\nIs encrypted. Enter the password:", pdfFileName2); 
      password = Console.ReadLine(); 
   } 
 
   // If the user entered the correct password (LEAD), you can open the file now 
   try 
   { 
      using (PDFDocument document = new PDFDocument(pdfFileName2, password)) 
      { 
         Console.WriteLine("Opened successfully"); 
      } 
   } 
   catch (Exception ex) 
   { 
      // Otherwise, you will get an error that the PDF file is corrupted 
      Console.WriteLine(ex.Message); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
} 
 
import java.io.BufferedWriter; 
import java.io.Console; 
import java.io.File; 
import java.io.FileWriter; 
import java.io.IOException; 
import java.io.OutputStream; 
import java.io.OutputStreamWriter; 
import java.nio.Buffer; 
import java.nio.file.Files; 
import java.nio.file.Path; 
import java.nio.file.Paths; 
import java.nio.file.StandardOpenOption; 
import java.sql.Date; 
import java.text.SimpleDateFormat; 
import java.time.LocalDateTime; 
import java.util.ArrayList; 
import java.util.List; 
 
import javax.xml.validation.Schema; 
 
import org.apache.lucene.store.Directory; 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.barcode.*; 
import leadtools.codecs.*; 
import leadtools.pdf.*; 
import leadtools.svg.*; 
 
 
public void pdfDocumentEncryptedExample() { 
   String LEAD_VARS_ImagesDir = "C:\\LEADTOOLS23\\Resources\\Images"; 
   String pdfFileName1 = combine(LEAD_VARS_ImagesDir, "Leadtools.pdf"); 
   String pdfFileName2 = combine(LEAD_VARS_ImagesDir, "Encrypted.pdf"); 
 
   // Create an encrypted version of Leadtools.pdf 
   PDFFile file = new PDFFile(pdfFileName1); 
   file.setSecurityOptions(new PDFSecurityOptions()); 
   file.getSecurityOptions().setUserPassword("LEAD"); 
   file.convert(1, -1, pdfFileName2); 
 
   // Now try to open it as a document 
   String password = null; 
 
   if (PDFFile.isEncrypted(pdfFileName2)) { 
      System.out.println(pdfFileName2 + "\nIs encrypted. Enter the password:"); 
      password = "your_custom_password"; 
   } 
 
   // If the user entered the correct password (LEAD), you can open the file now 
   try { 
      PDFDocument document = new PDFDocument(pdfFileName2, password); 
      System.out.println("Opened successfully"); 
 
   } catch (Exception ex) { 
      // Otherwise, you will get an error that the PDF file is corrupted 
      System.out.println(ex.getMessage()); 
   } 
} 
Requirements

Target Platforms

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Pdf Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.