DocWright.Composition
1.1.1
dotnet add package DocWright.Composition --version 1.1.1
NuGet\Install-Package DocWright.Composition -Version 1.1.1
<PackageReference Include="DocWright.Composition" Version="1.1.1" />
<PackageVersion Include="DocWright.Composition" Version="1.1.1" />
<PackageReference Include="DocWright.Composition" />
paket add DocWright.Composition --version 1.1.1
#r "nuget: DocWright.Composition, 1.1.1"
#:package DocWright.Composition@1.1.1
#addin nuget:?package=DocWright.Composition&version=1.1.1
#tool nuget:?package=DocWright.Composition&version=1.1.1
DocWright.Composition
Build a document from code with a fluent, declarative API — pages, headers, columns,
tables, text styling — then render it to PDF, images or .docx through the ordinary
pipeline.
A composition is plain C#, so loops, conditionals and your own data just work.
Add-on for DocWright.
Install
dotnet add package DocWright.Composition
This package brings the main DocWright package with it, so that single install is
enough.
Usage
using DocWright;
using DocWright.Composition;
using DocWright.Core.Primitives;
ComposedDocument invoice = ComposedDocument.Create(document =>
{
document.Page(page =>
{
page.Size(PageSizes.A4).Margin(2, Unit.Centimetre);
page.DefaultTextStyle(text => text.FontFamily("Calibri").FontSize(11));
page.Header().Text("INVOICE 2026-0042").FontSize(20).Bold();
page.Content().Column(column =>
{
column.Spacing(8);
column.Item().Text("Bill to: Contoso Ltd.");
column.Item().Table(table =>
{
table.Columns(columns =>
{
columns.Relative(3);
columns.Relative(1);
});
foreach (Line line in lines) // ordinary C#
{
table.Cell().Text(line.Description);
table.Cell().Text(line.Amount.ToString("C"));
}
});
});
page.Footer().Text(text => text.CurrentPageNumber().Literal(" / ").TotalPages());
});
});
Then render it however you like:
var converter = new DocWrightConverter();
using FileStream pdf = File.Create("invoice.pdf");
converter.Convert(invoice.ToDocument(), pdf);
Not a second engine
A composed document becomes a real document and goes through the same layout engine and
renderers as a loaded .docx. There is no separate rendering path to diverge, and you can
keep editing the result with the ordinary editing API before you save it.
Limits
CompositionOptions.MaxNestingDepth bounds how deeply a composition may nest:
ComposedDocument.Create(compose, new CompositionOptions { MaxNestingDepth = 8 });
Requirements
.NET Framework 4.8, .NET Standard 2.0, .NET 8.0 or .NET 10.0.
License
MIT.
| 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 is compatible. 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. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 is compatible. 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. |
-
.NETFramework 4.8
- DocWright (>= 1.1.1)
- Microsoft.Bcl.HashCode (>= 1.1.1)
- System.Buffers (>= 4.6.1)
- System.Memory (>= 4.6.3)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
-
.NETStandard 2.0
- DocWright (>= 1.1.1)
- Microsoft.Bcl.HashCode (>= 1.1.1)
- System.Buffers (>= 4.6.1)
- System.Memory (>= 4.6.3)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
-
net10.0
- DocWright (>= 1.1.1)
-
net8.0
- DocWright (>= 1.1.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
See https://github.com/albahadly/DocWright/releases for release notes.