QuestPDF 2021.11.3
See the version list below for details.
dotnet add package QuestPDF --version 2021.11.3
NuGet\Install-Package QuestPDF -Version 2021.11.3
<PackageReference Include="QuestPDF" Version="2021.11.3" />
paket add QuestPDF --version 2021.11.3
#r "nuget: QuestPDF, 2021.11.3"
// Install QuestPDF as a Cake Addin #addin nuget:?package=QuestPDF&version=2021.11.3 // Install QuestPDF as a Cake Tool #tool nuget:?package=QuestPDF&version=2021.11.3
QuestPDF Overview
QuestPDF is an open-source, modern and battle-tested library that can help you with generating PDF documents by offering friendly, discoverable and predictable C# fluent API.
Features
Rely on solid fundamentals - This library is created specifically for designing and arranging document layouts, with full paging support. Alternative solutions, such as HTML-based converters, are not designed for this purpose and therefore are often unpredictable and do not produce desired results.
Work with organized self-explanatory code - The entire process of implementing PDF document, takes place in your code. Free yourself from slow visual designers and strange technological limitations. Follow simple yet highly effective approaches to create maintainable, high-quality code.
Compose simple components into complex documents - Do you remember the feeling when your code just works? When your ideas are becoming real without any effort? Working with simple, easy to understand, self-explanatory and highly composable layout elements is the key here!
Create and reuse components - Feel no fear of complex documents! Create custom, reusable components and divide the document's layout into easy to maintain pieces. Inject data to customize content and use slots to enhance composability. Decide how complex approaches your solution needs and follow the best path.
Prototype with ease - We understand that document generation is often tricky and require multiple iterations. The library offers additional prototyping tools such as random text generator or image placeholder element. By following best practices, you can develop a document without having data.
Enjoy fast PDF generation - QuestPDF is created upon SkiaSharp, a well-known graphical library, and converts your data into PDF documents. It offers a highly optimized layouting engine capable of generating over 1000 PDF files per minute per core. The entire process is thread-safe.
Learning resources
Release notes and roadmap - everything that is planned for future library iterations, description of new features and information about potential breaking changes.
Getting started tutorial - a short and easy to follow tutorial showing how to design an invoice document under 200 lines of code.
API Reference - a detailed description of behavior of all available components and how to use them with C# Fluent API.
Patterns and practices - everything that may help you designing great reports and reusable code that is easy to maintain.
Example invoice
Do you believe that creating a complete invoice document can take less than 200 lines of code? We have prepared for you a step-by-step instruction that shows every detail of this implementation and describes the best patterns and practices.
For tutorial, documentation and API reference, please visit the QuestPDF documentation.
Here you can find an example code showing how easy is to write and understand the fluent API.
General document structure with header, content and footer:
public void Compose(IDocumentContainer container)
{
container
.Page(page =>
{
page.Margin(50);
page.Header().Element(ComposeHeader);
page.Content().Element(ComposeContent);
page.Footer().AlignCenter().Text(x =>
{
x.CurrentPageNumber();
x.Span(" / ");
x.TotalPages();
});
});
}
The header area consists of basic invoice information along with a logo placeholder.
void ComposeHeader(IContainer container)
{
var titleTextStyle = TextStyle.Default.Size(20).SemiBold().Color(Colors.Blue.Medium);
container.Row(row =>
{
{
stack.Item().Text($"Invoice #{Model.InvoiceNumber}", titleStyle);
stack.Item().Text(text =>
{
text.Span("Issue date: ", TextStyle.Default.SemiBold());
text.Span($"{Model.IssueDate:d}");
});
stack.Item().Text(text =>
{
text.Span("Due date: ", TextStyle.Default.SemiBold());
text.Span($"{Model.DueDate:d}");
});
});
row.ConstantColumn(100).Height(50).Placeholder();
});
}
Implementation of the content area that contains seller and customer details, then listing of all bought products, then a comments section.
void ComposeContent(IContainer container)
{
container.PaddingVertical(40).Stack(column =>
{
column.Spacing(20);
column.Item().Row(row =>
{
row.RelativeColumn().Component(new AddressComponent("From", Model.SellerAddress));
row.ConstantColumn(50);
row.RelativeColumn().Component(new AddressComponent("For", Model.CustomerAddress));
});
column.Item().Element(ComposeTable);
var totalPrice = Model.Items.Sum(x => x.Price * x.Quantity);
column
.Item()
.PaddingRight(5)
.AlignRight()
.Text($"Grand total: {totalPrice}$", TextStyle.Default.SemiBold());
if (!string.IsNullOrWhiteSpace(Model.Comments))
column.Item().PaddingTop(25).Element(ComposeComments);
});
}
The table and comments codes are extracted into separate methods to increase clarity:
void ComposeTable(IContainer container)
{
var headerStyle = TextStyle.Default.SemiBold();
container.Decoration(decoration =>
{
// header
decoration.Header().BorderBottom(1).Padding(5).Row(row =>
{
row.ConstantColumn(25).Text("#", headerStyle);
row.RelativeColumn(3).Text("Product", headerStyle);
row.RelativeColumn().AlignRight().Text("Unit price", headerStyle);
row.RelativeColumn().AlignRight().Text("Quantity", headerStyle);
row.RelativeColumn().AlignRight().Text("Total", headerStyle);
});
// content
decoration
.Content()
.Stack(column =>
{
foreach (var item in Model.Items)
{
column
.Item()
.ShowEntire()
.BorderBottom(1)
.BorderColor(Colors.Grey.Lighten2)
.Padding(5)
.Row(row =>
{
row.ConstantColumn(25).Text(Model.Items.IndexOf(item) + 1);
row.RelativeColumn(3).Text(item.Name);
row.RelativeColumn().AlignRight().Text($"{item.Price}$");
row.RelativeColumn().AlignRight().Text(item.Quantity);
row.RelativeColumn().AlignRight().Text($"{item.Price * item.Quantity}$");
});
}
});
});
}
void ComposeComments(IContainer container)
{
container.ShowEntire().Background(Colors.Grey.Lighten3).Padding(10).Stack(message =>
{
message.Spacing(5);
message.Item().Text("Comments", TextStyle.Default.Size(14).SemiBold());
message.Item().Text(Model.Comments);
});
}
The address details section is implemented using components. This way the code can be easily reused for both seller and customer:
public class AddressComponent : IComponent
{
private string Title { get; }
private Address Address { get; }
public AddressComponent(string title, Address address)
{
Title = title;
Address = address;
}
public void Compose(IContainer container)
{
container.ShowEntire().Stack(column =>
{
column.Spacing(5);
column
.Item()
.BorderBottom(1)
.PaddingBottom(5)
.Text(Title, TextStyle.Default.SemiBold());
column.Item().Text(Address.CompanyName);
column.Item().Text(Address.Street);
column.Item().Text($"{Address.City}, {Address.State}");
column.Item().Text(Address.Email);
column.Item().Text(Address.Phone);
});
}
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 is compatible. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 is compatible. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
NuGet packages (41)
Showing the top 5 NuGet packages that depend on QuestPDF:
Package | Downloads |
---|---|
AgentHub.Service.Financial.Domain.Shared
Package Description |
|
HTMLToQPDF
Relorer.QuestPDF.HTML is an extension for QuestPDF that allows to generate PDF from HTML |
|
DH.QuestPDF
DH框架的Pdf处理库。基于https://github.com/QuestPDF/QuestPDF |
|
Verify.QuestPDF
Extends Verify (https://github.com/VerifyTests/Verify) to allow verification via QuestPDF. |
|
QuestPDF.Markdown
QuestPDF.Markdown is an open-source helper library that allows rendering markdown into a QuestPDF document |
GitHub repositories (15)
Showing the top 5 popular GitHub repositories that depend on QuestPDF:
Repository | Stars |
---|---|
nopSolutions/nopCommerce
ASP.NET Core eCommerce software. nopCommerce is a free and open-source shopping cart.
|
|
beto-rodriguez/LiveCharts2
Simple, flexible, interactive & powerful charts, maps and gauges for .Net, LiveCharts2 can now practically run everywhere Maui, Uno Platform, Blazor-wasm, WPF, WinForms, Xamarin, Avalonia, WinUI, UWP.
|
|
Pixeval/Pixeval
Wow. Yet another Pixiv client!
|
|
ariacom/Seal-Report
Database Reporting Tool and Tasks (.Net)
|
|
neozhu/CleanArchitectureWithBlazorServer
This is a repository for creating a Blazor Server dashboard application following the principles of Clean Architecture
|
Version | Downloads | Last updated | |
---|---|---|---|
2024.10.2 | 13,358 | 10/24/2024 | |
2024.10.1 | 23,901 | 10/14/2024 | |
2024.10.0 | 23,840 | 10/4/2024 | |
2024.10.0-rc4 | 1,528 | 9/26/2024 | |
2024.10.0-rc3 | 4,455 | 9/17/2024 | |
2024.10.0-rc2 | 277 | 9/16/2024 | |
2024.10.0-rc1 | 275 | 9/13/2024 | |
2024.10.0-rc0 | 2,573 | 9/4/2024 | |
2024.7.3 | 128,325 | 8/27/2024 | |
2024.7.2 | 98,670 | 8/1/2024 | |
2024.7.1 | 50,812 | 7/22/2024 | |
2024.7.0 | 29,979 | 7/15/2024 | |
2024.7.0-rc0 | 1,528 | 7/4/2024 | |
2024.6.4 | 65,248 | 6/25/2024 | |
2024.6.3 | 323 | 6/25/2024 | |
2024.6.2 | 24,063 | 6/20/2024 | |
2024.6.1 | 20,112 | 6/15/2024 | |
2024.6.0 | 43,264 | 6/11/2024 | |
2024.3.10 | 72,985 | 5/25/2024 | |
2024.3.9 | 8,211 | 5/23/2024 | |
2024.3.8 | 222 | 5/23/2024 | |
2024.3.7 | 19,841 | 5/20/2024 | |
2024.3.6 | 31,370 | 5/14/2024 | |
2024.3.5 | 22,592 | 5/12/2024 | |
2024.3.4 | 24,996 | 5/6/2024 | |
2024.3.3 | 9,100 | 5/2/2024 | |
2024.3.2 | 29,627 | 4/25/2024 | |
2024.3.1 | 29,555 | 4/22/2024 | |
2024.3.0 | 55,684 | 4/12/2024 | |
2024.3.0-rc2 | 3,986 | 3/30/2024 | |
2024.3.0-rc1 | 233 | 3/29/2024 | |
2024.3.0-rc | 607 | 3/27/2024 | |
2024.3.0-beta1 | 2,071 | 3/18/2024 | |
2024.3.0-beta | 3,372 | 2/29/2024 | |
2024.3.0-alpha | 1,662 | 2/15/2024 | |
2023.12.6 | 270,856 | 2/21/2024 | |
2023.12.5 | 69,425 | 2/7/2024 | |
2023.12.4 | 135,847 | 1/15/2024 | |
2023.12.3 | 19,603 | 1/12/2024 | |
2023.12.2 | 58,509 | 1/1/2024 | |
2023.12.1 | 65,399 | 12/15/2023 | |
2023.12.0 | 50,326 | 12/3/2023 | |
2023.10.2 | 82,413 | 11/13/2023 | |
2023.10.1 | 43,121 | 10/31/2023 | |
2023.10.0 | 31,661 | 10/23/2023 | |
2023.10.0-alpha0 | 370 | 10/13/2023 | |
2023.9.1 | 44,936 | 10/6/2023 | |
2023.9.0 | 36,307 | 9/25/2023 | |
2023.6.3 | 137,244 | 8/27/2023 | |
2023.6.2 | 633 | 8/26/2023 | |
2023.6.1 | 101,571 | 7/20/2023 | |
2023.6.0 | 72,095 | 6/28/2023 | |
2023.5.3 | 84,729 | 6/12/2023 | |
2023.5.2 | 60,455 | 5/31/2023 | |
2023.5.1 | 27,264 | 5/22/2023 | |
2023.5.0 | 12,477 | 5/15/2023 | |
2023.4.2 | 14,061 | 5/9/2023 | |
2023.4.1 | 4,621 | 5/4/2023 | |
2023.4.0 | 1,305 | 5/4/2023 | |
2022.12.15 | 197,940 | 2/7/2024 | |
2022.12.14 | 30,111 | 1/12/2024 | |
2022.12.13 | 8,997 | 1/1/2024 | |
2022.12.12 | 23,449 | 12/15/2023 | |
2022.12.11 | 19,917 | 12/3/2023 | |
2022.12.10 | 11,256 | 11/13/2023 | |
2022.12.9 | 3,297 | 10/31/2023 | |
2022.12.8 | 22,340 | 10/23/2023 | |
2022.12.7 | 89,544 | 10/6/2023 | |
2022.12.6 | 452,346 | 5/9/2023 | |
2022.12.5 | 149,563 | 4/27/2023 | |
2022.12.4 | 32,995 | 4/22/2023 | |
2022.12.3 | 76,602 | 4/16/2023 | |
2022.12.2 | 315,481 | 3/12/2023 | |
2022.12.1 | 570,304 | 1/13/2023 | |
2022.12.0 | 155,210 | 12/14/2022 | |
2022.11.0 | 386,193 | 11/5/2022 | |
2022.11.0-alpha1 | 356 | 11/1/2022 | |
2022.11.0-alpha0 | 319 | 10/28/2022 | |
2022.9.1 | 92,342 | 10/15/2022 | |
2022.9.0 | 138,611 | 9/18/2022 | |
2022.9.0-alpha1 | 300 | 9/16/2022 | |
2022.8.2 | 165,759 | 8/21/2022 | |
2022.8.1 | 21,019 | 8/19/2022 | |
2022.8.0 | 97,216 | 8/15/2022 | |
2022.6.3 | 54,954 | 7/18/2022 | |
2022.6.2 | 128,347 | 6/22/2022 | |
2022.6.1 | 23,095 | 6/12/2022 | |
2022.6.0 | 159,171 | 6/12/2022 | |
2022.6.0-prerelease | 1,754 | 5/30/2022 | |
2022.5.0 | 284,956 | 5/9/2022 | |
2022.4.1 | 109,960 | 4/8/2022 | |
2022.4.0 | 69,833 | 4/4/2022 | |
2022.4.0-alpha1 | 336 | 3/27/2022 | |
2022.4.0-alpha0 | 304 | 3/27/2022 | |
2022.3.1 | 98,631 | 3/15/2022 | |
2022.3.0 | 2,563 | 3/14/2022 | |
2022.2.7 | 1,761 | 3/12/2022 | |
2022.2.6 | 6,571 | 3/8/2022 | |
2022.2.5 | 20,460 | 2/18/2022 | |
2022.2.4 | 705 | 2/18/2022 | |
2022.2.3 | 11,181 | 2/7/2022 | |
2022.2.2 | 2,058 | 2/1/2022 | |
2022.2.1 | 1,620 | 1/30/2022 | |
2022.2.0 | 1,879 | 1/29/2022 | |
2022.2.0-beta1 | 330 | 1/24/2022 | |
2022.1.0 | 25,716 | 1/10/2022 | |
2022.1.0-beta5 | 983 | 1/7/2022 | |
2022.1.0-beta4 | 343 | 1/6/2022 | |
2022.1.0-beta3 | 315 | 1/5/2022 | |
2022.1.0-beta2 | 329 | 1/5/2022 | |
2022.1.0-beta1 | 333 | 1/3/2022 | |
2022.1.0-beta0 | 309 | 12/30/2021 | |
2022.1.0-alpha0 | 359 | 12/30/2021 | |
2021.12.0 | 32,243 | 12/6/2021 | |
2021.12.0-alpha1 | 1,161 | 11/29/2021 | |
2021.12.0-alpha0 | 388 | 11/18/2021 | |
2021.11.4 | 22,593 | 11/14/2021 | |
2021.11.3 | 4,907 | 11/7/2021 | |
2021.11.0-beta3 | 401 | 11/3/2021 | |
2021.11.0-beta2 | 431 | 10/28/2021 | |
2021.11.0-beta | 464 | 10/23/2021 | |
2021.10.1 | 10,087 | 9/30/2021 | |
2021.10.0 | 611 | 9/30/2021 | |
2021.10.0-beta.2 | 277 | 9/14/2021 | |
2021.10.0-beta | 417 | 9/13/2021 | |
2021.9.3 | 6,267 | 9/12/2021 | |
2021.9.2 | 729 | 9/1/2021 | |
2021.9.1 | 561 | 9/1/2021 | |
2021.9.0 | 524 | 8/30/2021 | |
2021.8.0 | 2,492 | 8/2/2021 | |
2021.5.2 | 3,262 | 5/5/2021 | |
2021.4.0 | 770 | 4/2/2021 | |
2021.3.1 | 7,125 | 3/1/2021 | |
2021.3.0 | 578 | 3/1/2021 | |
2021.2.0 | 631 | 2/8/2021 | |
2021.1.0 | 693 | 1/4/2021 | |
2020.11.0 | 10,617 | 11/1/2020 |
- Added new Inlined element - put block elements along a line with line-breaking and page-breaking support. This element also supports various element placement in the horizontal axis as well as the baseline. It will help me in future development, especially with text rendering optimization,
- Introduced a new SkipOnce element - it can be used to hide content on the first occurrence of the parent. Useful in conjunction with the ShowOnce element. This change was proposed by jcl86, thank you!
- Improved debugging experience by providing more detailed messages when the DocumentLayoutException is thrown. This improvement is based on the discussion started by preiius, thank you!
- Now it is possible to specify global, document-specific text style. This improves text style management and simplifies the typography pattern. This feature was proposed by JonnyBooker, thank you!
- Added two overloads to the Image element. Now, you can provide an image as a filePath or a Stream. This improvement was suggested by pha3z. Thank you!
- Improved text rendering performance.
- Improved documentation examples for the ShowOnce and the EnsureSpace elements.
- Improved text element: it does not throw an exception when an argument is null.
- All new releases of QuestPDF will contain symbol packages. Let's welcome simplified debugging experience 🎉