.NET Interface

The .NET Interface makes it possible for the XSL Formatter V3.4 to function through .NET applications developed using Visual Basic.NET, Visual C#.NET and so on.

The operation of the .NET Interface has been tried and tested in the following .NET environments:

• Microsoft .NET Framework 1.0
• Microsoft .NET Framework 1.1

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

The initialization and the termination are necessary to use the DLL. That is, before using the DLL, Initialize method must be called. After using the DLL, Terminate method must be called.

The following classes are contained in the .NET component.

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

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

XfoObj Class provides the following methods.

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 sample C# of program. In addition, [Install directory]/samples/dotnet includes some useful sample files for C# and VisualBasic.NET.

using System;

public class MainApp
{
    static public void Main()
    {
        XfoDotNetCtl.XfoObj.Initialize();
        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();
            XfoDotNetCtl.XfoObj.Terminate();
        }
    }
}