LEADTOOLS Image File Support (Leadtools.Codecs assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
InitialPath Property
See Also 
Leadtools.Codecs Namespace > CodecsPdfOptions Class : InitialPath Property



Gets and sets the path to the PDF runtime DLL.

Syntax

Visual Basic (Declaration) 
Public Property InitialPath As String
Visual Basic (Usage)Copy Code
Dim instance As CodecsPdfOptions
Dim value As String
 
instance.InitialPath = value
 
value = instance.InitialPath
C# 
public string InitialPath {get; set;}
C++/CLI 
public:
property String^ InitialPath {
   String^ get();
   void set (    String^ value);
}

Property Value

The path to the PDF runtime files, or an empty string or null (Nothing in Visual Basic), if the default location is to be used.

Example

For an example, refer to CodecsPdfOptions.

Remarks

The PDF runtime DLL is Leadtools.PdfEngine.dll. This DLL is never referenced directly by the LEADTOOLS Raster PDF file filter (Leadtools.Codecs.Pdf), instead it is loaded dynamically and out of process by the filter.

By default, the LEADTOOLS installer will copy this DLL next to the filter (in the Bin\DotNet\Win32, Bin\DotNet\x64, Bin\DotNet4\Win32 and Bin\DotNet4\x64 folders) and the filter will look for the engine DLL in the same folder it is located (default location).

In some cases, you can share the same copy of Leadtools.PdfEngine.dll between different applications. For example, many ASP.NET web applications, in this case, you can copy Leadtools.PdfEngine.dll to a fixed directory on your server and pass the name of this directory to InitialPath. From this point on, LEADTOOLS will use this value to locate and load Leadtools.PdfEngine.dll.

Note that setting this value in a RasterCodecs object will affect all the RasterCodecs objects that are currently created in the application (in all threads) or will be created in the future, for example:

    
             RasterCodecs codecs1 = new RasterCodecs();
             codecs1.Options.Pdf.InitialPath = @"C:\MyApp\Bin";
             codecs1.Dispose();
            
             RasterCodecs codecs2 = new RasterCodecs();
             // This will work even though the RasterCodecs object that set this value has been disposed.
             System.Diagnostics.Debug.Assert(codecs2.Options.Pdf.InitialPath == @"C:\MyApp\Bin");
             

  

Requirements

Target Platforms: Silverlight, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also