.NET Interface

The .NET Interface makes it possible for Antenna House Formatter V7.4 to function through .NET applications developed using Visual Basic.NET, Visual C#.NET and similar programs.

The .NET interface has been tried and tested in the following Microsoft .NET Framework and .NET environments.

• Microsoft .NET Framework 4.5.2
• Microsoft .NET Framework 4.6.x
• Microsoft .NET Framework 4.7.x
• Microsoft .NET Framework 4.8
• .NET 6

Antenna House Formatter .NET component is not registered automatically to the global assembly cache (GAC). It is necessary to create the path either by putting the .NET component in the current folder of the application, or by creating an application configuration file.

To run the .NET interface, you must include [Install directory] in Windows versions and [Install directory]/​lib in non-Windows versions in the search path for shared libraries at runtime. In Windows versions, the above path is added to the environment variable PATH during installation, so no additional settings are required. It is necessary to add [Install directory]/​lib to the search path of the shared library at runtime, such as setting the environment variable LD_LIBRARY_PATH in the Linux version (64-bit version) and the environment variable DYLD_LIBRARY_PATH in the Macintosh version (64-bit version). See also Environment Variables for the necessary environment variables.

The following classes are contained in the .NET component:

XfoDotNetCtl.XfoObj obj = new XfoDotNetCtl.XfoObj();
try {
  // some process
} finally {
  obj.Dispose();
}

XfoException Class includes the following properties:

XfoObj Class includes the following properties:

xslt %param -o %3 %1 %2

-p %p %v

Properties – PDF Settings

Properties – SVG Settings

Properties – Printer Settings

Properties – Smoothing Settings

Properties – Watermark-Text Settings

Values can be added using the following units:

XfoObj Class provides the following methods:

XfoObj provides the following events:

It's possible to directly output PDF to the Web Browser, when you use ASP.NET application on a server and output the formatted result in PDF. The following is its sample of program.

public class TestPage : Page
{
    public void OnStreamPDF(Object sender, EventArgs ea)
    {
        XfoDotNetCtl.XfoObj obj = new XfoDotNetCtl.XfoObj();
        obj.ExitLevel = 4;
        FileStream fs = null;
        try
        {
            fs = File.Open("c:\\temp\\sample.fo", FileMode.Open, FileAccess.Read);
            Response.Clear();
            Response.ContentType = "application/pdf";
            obj.Render(fs1, Response.OutputStream);
            Response.End();
        }
        catch(Exception e)
        {
            throw e;
        }
        finally
        {
            if (fs != null)
                fs.Close();
        }
    }
}

The following is a C# programming sample. In addition, you can download simple sample programs from our website.

using System;

public class MainApp
{
    static public void Main()
    {
        XfoDotNetCtl.XfoObj obj = new XfoDotNetCtl.XfoObj();
        obj.DocumentURI = "c:\\temp\\test.xml";
        obj.StylesheetURI = "c:\\temp\\test.xsl";
        obj.OutputFilePath = "c:\\temp\\test.pdf";
        obj.ExitLevel = 4;
        try
        {
            obj.Execute();
        }
        catch(XfoException e)
        {
            Console.WriteLine("ErrCode : " + e.ErrorCode + "\n" + e.Message);
        }
        catch(Exception e)
        {
            Console.WriteLine(e.Message);
        }
        finally
        {
            obj.Dispose();
        }
    }
}

Simple sample programs can be downloaded from our website. The downloaded sample programs include sample files for C#, VisualBasic.NET and a sample project file for .NET. To run the .NET interface, you need to register components and add search paths for shared libraries. You also need to set environment variables to run the sample on Linux version (64-bit version), Macintosh version (64-bit version). See Component Registration and Environment Variables for more information.

.NET Framework

> cd dotnet\cs
> C:\Windows\Microsoft.NET\Framework64\[.NET version]\csc sample.cs /r:[Install directory]\XfoDotNet40Ctl74.dll
> copy [Install directory]\XfoDotNet40Ctl74.dll .
> sample.exe sample.fo sample.pdf

> cd dotnet\cs
> C:\Windows\Microsoft.NET\Framework\[.NET version]\csc sample.cs /platform:x86 /r:[Install directory]\XfoDotNet40Ctl74.dll
> copy [Install directory]\XfoDotNet40Ctl74.dll .
> sample.exe sample.fo sample.pdf

.NET

> cd dotnet\cs
> copy [Install directory]\XfoDotNetCore31Ctl74.dll .
> dotnet run --runtime=win-x64 --no-self-contained sample.fo sample.pdf

> cd dotnet\cs
> copy [Install directory]\XfoDotNetCore31Ctl74.dll .
> dotnet run --runtime=win-x86 --no-self-contained sample.fo sample.pdf

$ cd dotnet/cs
$ cp [Install directory]/lib/XfoDotNetCore31Ctl74.dll .
$ AHF74_64_FONT_CONFIGFILE=[Install directory]/etc/font-config.xml
$ export AHF74_64_FONT_CONFIGFILE
$ AHF74_64_LIC_PATH=[Install directory]/etc
$ export AHF74_64_LIC_PATH
$ LD_LIBRARY_PATH=[Install directory]/lib:${LD_LIBRARY_PATH}
$ export LD_LIBRARY_PATH
$ dotnet run --runtime=linux-x64 --no-self-contained sample.fo sample.pdf

$ cd dotnet/cs
$ cp [Install directory]/lib/XfoDotNetCore31Ctl74.dll .
$ AHF74_64_FONT_CONFIGFILE=[Install directory]/etc/font-config.xml
$ export AHF74_64_FONT_CONFIGFILE
$ AHF74_64_LIC_PATH=[Install directory]/etc
$ export AHF74_64_LIC_PATH
$ DYLD_LIBRARY_PATH=[Install directory]/lib:${DYLD_LIBRARY_PATH}
$ export DYLD_LIBRARY_PATH
$ dotnet run --runtime=osx-x64 --no-self-contained sample.fo sample.pdf

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>
 <ItemGroup>
  <Reference Include="./XfoDotNetCore31Ctl74.dll" />
 </ItemGroup>
</Project>