High level C# library for the easy creation of PDF documents using PdfSharp. Use this library to create beautiful and complex PDF's using a structure similar to XAML with model binding. Objects called PdfSections are aligned to a grid by stacking or creating a parent/child heirarchy. The rendering engine will flow the sections and align them to the grid creating perfect PDF documents every time.
The PDF Documents in this library are based on data models. The PDF document uses binding to retrieve data from the instance of the model passed when building the PDF document.
Create a new class in the solution called Message.cs and paste the code shown below into the class.
namespace PdfDocuments.Example.Simple
{
public class Message : IPdfModel
{
public string Id { get; set; }
public string Text { get; set; }
}
}
Create PDF Document Generator Class
Create a new class call HelloWorld.cs in the solution and copy the code below to the class.
using PdfSharp.Drawing;
using System.Threading.Tasks;
namespace PdfDocuments.Example.Simple
{
public class HelloWorld : PdfGenerator<Message>
{
public HelloWorld(IPdfStyleManager<Message> styleManager)
: base(styleManager)
{
}
protected override Task OnInitializeStylesAsync(IPdfStyleManager<Message> styleManager)
{
//
// Add a style for the text. The style name is referenced in the
// content creation.
//
this.StyleManager.Add("HelloWorld.Text", Style.Create<Message>()
.UseFont("Arial", 48)
.UseForegroundColor(XColors.Purple)
.UseBorderWidth(1)
.UseTextAlignment(XStringFormats.Center)
.UsePadding(10, 10, 10, 10)
.Build());
return Task.CompletedTask;
}
protected override Task<IPdfSection<Message>> OnAddContentAsync()
{
//
// Add a basic text block using the style that was created.
//
return Task.FromResult(Pdf.TextBlockSection<Message>()
.WithText((g, m) => m.Text)
.WithStyles("HelloWorld.Text"));
}
}
}
The class above overrides OnInitializeStylesAsync to create a single style that is used to style the text. The name of the styles does not matter as long as the style name is referenced with the same name in the section referencing the style.
the class also overrides OnAddContentAsync(). This method is where all of the content for the PDF is added. In this method, there is one section being added using the style that was defined previously. The Text property of the section is bound to the Text property of the Message model.
Generate the PDF
Open the Program.cs file again and add a line to create a new Style Manager instance as shown below.
PdfStyleManager<Message> styleManager = new PdfStyleManager<Message>();
Next add a statement to create an instance of the HelloWorld PDF document as shown below. Notice the Style manager instance is passed into the constructor.
HelloWorld helloWorld = new HelloWorld(styleManager);
Next, create an instance of the data model.
Message model = new Message() { Id = "12345", Text = "Hello World" };
Now we can generate a PDF. The Build() method will create the PDF into a byte array. This byte array can be saved to disk or returned by a REST API to a client application without the need to write to disk first.
The Build method return a Tuple where the first element is a Boolean and indicates if the PDF was successfully created or not. If successful, the second element contains the PDF byte array.
Let's write the PDF to disk. The code below will save the PDF to the desktop folder of the current user using the model type name and Id property of the model to name the file.
In more complex documents, it may be necessary to troubleshoot layout and fonts. There are a few debug flags that can be set to reveal the details of how the document was rendered.
