PDFsharp

https://docs.pdfsharp.net
Admin
PDFsharp is a .NET library for processing PDF files with low-level control over graphics and text,...
Tokens:118,095
Snippets:1,079
Trust Score:9.2
Update:1 week ago
Show doc for...
Tokens:
Raw
### Complete source code for First PDF example

Source: https://docs.pdfsharp.net/PDFsharp/Topics/Start/First-PDF.html

Complete source code for creating a PDF document with graphics and text, saving it, and starting a viewer.

```csharp
// PDFsharp - A .NET library for processing PDF
// See the LICENSE file in the solution root for more information.

using PdfSharp;
using PdfSharp.Drawing;
using PdfSharp.Fonts;
using PdfSharp.Pdf;
using PdfSharp.Quality;
using PdfSharp.Snippets.Font;

// Create a new PDF document.
var document = new PdfDocument();
document.Info.Title = "Created with PDFsharp";
document.Info.Subject = "Just a simple Hello-World program.";

// Create an empty page in this document.
var page = document.AddPage();

// Get an XGraphics object for drawing on this page.
var gfx = XGraphics.FromPdfPage(page);

// Draw two lines with a red default pen.
var width = page.Width.Point;
var height = page.Height.Point;
gfx.DrawLine(XPens.Red, 0, 0, width, height);
gfx.DrawLine(XPens.Red, width, 0, 0, height);

// Draw a circle with a red pen which is 1.5 point thick.
var r = width / 5;
gfx.DrawEllipse(new XPen(XColors.Red, 1.5), XBrushes.White, new XRect(width / 2 - r, height / 2 - r, 2 * r, 2 * r));

// Create a font.
var font = new XFont("Times New Roman", 20, XFontStyleEx.BoldItalic);

// Draw the text.
gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
    new XRect(0, 0, page.Width, page.Height), XStringFormats.Center);

// Save the document...
var filename = IOUtility.GetTempPdfFullFileName("HelloWorldSample");
document.Save(filename);
// ...and start a viewer.
PdfFileUtility.StartPdfViewer(filename);

```

--------------------------------

### Create section and set page setup

Source: https://docs.pdfsharp.net/MigraDoc/Topics/Start/HelloMigraDoc.html

Adds a section to the document and configures the page setup to use different headers and footers for odd and even pages, and to start page numbering at 1.

```csharp
var section = document.AddSection();
section.PageSetup.OddAndEvenPagesHeaderFooter = true;
section.PageSetup.StartingNumber = 1;

```

--------------------------------

### Table Inheritance Example

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Contents/Tables.html

Demonstrates setting direct formatting at different levels to observe how properties are inherited in a MigraDoc table.

```csharp
// Set and use direct formatting at different levels to show how inheritance works in tables.

// Add table and set format.
var table = section.AddTable();
table.Borders.Visible = true;
table.Format.Font.Size = Unit.FromPoint(8);

// Add first column.
var columnA = table.AddColumn();

// Add second column and set format.
var columnB = table.AddColumn();
columnB.Format.Font.Bold = true;

// Add third column and set format.
var columnC = table.AddColumn();
columnC.Format.Alignment = ParagraphAlignment.Center;
columnC.Format.Font.Color = Colors.Red;

// Set format for all rows.
table.Rows.Height = Unit.FromPoint(25);

// Add first row and set format.
var row1 = table.AddRow();
row1.VerticalAlignment = VerticalAlignment.Center;

// Get first cell of row1.
var cellA1 = row1[0];

// Add paragraph to cellA1.
cellA1.AddParagraph("Text A1");

// Get second cell of row1.
var cellB1 = row1[1];

// Add paragraph to cellB1.
cellB1.AddParagraph("Text B1");

// Get third cell of row1.
var cellC1 = row1[2];

// Add paragraph to cellC1.
cellC1.AddParagraph("Text C1");

// Add second row and set format.
var row2 = table.AddRow();
row2.Format.Font.Italic = true;

// Get first cell of row2.
var cellA2 = row2[0];

// Add paragraph to cellA2.
cellA2.AddParagraph("Text A2");

// Get second cell of row2.
var cellB2 = row2[1];

// Add paragraph to cellB2.
cellB2.AddParagraph("Text B2");

// Get third cell of row2.
var cellC2 = row2[2];

// Add paragraph to cellC2.
cellC2.AddParagraph("Text C2");

// Add third row and set format.
var row3 = table.AddRow();
row3.VerticalAlignment = VerticalAlignment.Bottom;
row3.Format.Font.Color = Colors.Green;

// Get first cell of row3.
var cellA3 = row3[0];

// Add paragraph to cellA3.
cellA3.AddParagraph("Text A3");

// Get second cell of row3.
var cellB3 = row3[1];

// Add paragraph to cellB3.
cellB3.AddParagraph("Text B3");

// Get third cell of row3.
var cellC3 = row3[2];

// Add paragraph to cellC3.
cellC3.AddParagraph("Text C3");
```

--------------------------------

### Open PDF file with Process.Start and UseShellExecute (new .NET)

Source: https://docs.pdfsharp.net/General/Overview/Upgrade-to-PDFsharp-6.html

With .NET you have to add UseShellExecute = true to get the old behavior under Windows.

```csharp
    Process.Start(new ProcessStartInfo(filename) { UseShellExecute = true });

```

--------------------------------

### Reset to DefaultPageSetup

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Formats/PageSetup.html

Assigns a clone of the document's default page setup to a section to prevent inheritance from the previous section. The default page setup itself is unchangeable.

```csharp
// Reset to DefaultPageSetup.
section.PageSetup = document.DefaultPageSetup.Clone();

```

--------------------------------

### Table Inheritance with Explanatory Comments

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Contents/Tables.html

The same table inheritance example with added comments explaining which properties are inherited or overridden at each level.

```csharp
// Set and use direct formatting at different levels to show how inheritance works in tables.
// Overridden and inherited values are explained for each document object in the following comments.

// Add table and set format.
var table = section.AddTable();
table.Borders.Visible = true;
table.Format.Font.Size = Unit.FromPoint(8);

// Add first column.
var columnA = table.AddColumn();
// 'Borders.Visible = true' will be inherited from table.
// 'Format.Font.Size = Unit.FromPoint(8)' will be inherited from table.

// Add second column and set format.
var columnB = table.AddColumn();
columnB.Format.Font.Bold = true;
// 'Borders.Visible = true' will be inherited from table.
// 'Format.Font.Size = Unit.FromPoint(8)' will be inherited from table.

// Add third column and set format.
var columnC = table.AddColumn();
columnC.Format.Alignment = ParagraphAlignment.Center;
columnC.Format.Font.Color = Colors.Red;
// 'Borders.Visible = true' will be inherited from table.
// 'Format.Font.Size = Unit.FromPoint(8)' will be inherited from table.

// Set format for all rows.
table.Rows.Height = Unit.FromPoint(25);

// Add first row and set format.
var row1 = table.AddRow();
row1.VerticalAlignment = VerticalAlignment.Center;
// 'Borders.Visible = true' will be inherited from table.
// 'Format.Font.Size = Unit.FromPoint(8)' will be inherited from table.
// 'Height = Unit.FromPoint(25)' will be inherited from rows.

// Get first cell of row1.
var cellA1 = row1[0];
// 'Borders.Visible = true' will be inherited from row1 (same value as columnA) > table.
// 'Format.Font.Size = Unit.FromPoint(8)' will be inherited from row1 (same value as columnA) > table.
// 'Height = Unit.FromPoint(25)' will be inherited from row1 > rows.
// 'VerticalAlignment = Center' will be inherited from row1.

// Add paragraph to cellA1.
cellA1.AddParagraph("Text A1");
// 'Format.Font.Size = Unit.FromPoint(8)' will be inherited from cellA1 > row1 (same value as columnA) > table.
```

--------------------------------

### Clone PDFsharp and PDFsharp.Samples repositories

Source: https://docs.pdfsharp.net/General/Overview/Build-PDFsharp.html

Clone both repositories from GitHub. Only git clone gets the tags required by git-version for semantic versioning; downloading a ZIP file will cause git-version to crash.

```bash
git clone https://github.com/empira/PDFsharp.git
git clone https://github.com/empira/PDFsharp.Samples.git

```

--------------------------------

### Set up primary and even page headers and footers

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Contents/HeadersAndFooters.html

Enables odd/even page headers and footers, sets up a primary header, clones it for even pages, and creates footers with page numbers on the right (primary) and left (even). Requires the footer style from the previous example.

```csharp
// Use the EvenPage header and footer.
section.PageSetup.OddAndEvenPagesHeaderFooter = true;
…
// Set up primary header with short document title.
var header = section.Headers.Primary;
header.AddParagraph("Test document");

// Despite of OddAndEvenPagesHeaderFooter, even pages shall use the same header as odd ones.
section.Headers.EvenPage = section.Headers.Primary.Clone();
…
// Set up primary footer with page number on the right.
var footer = section.Footers.Primary;
var paragraph = footer.AddParagraph("\tSection one\t");
paragraph.AddPageField();

// Set up even page footer with page number on the left.
footer = section.Footers.EvenPage;
paragraph = footer.AddParagraph();
paragraph.AddPageField();
paragraph.AddText("\tSection one");

```

--------------------------------

### Base API example with Article, Heading1, and Paragraph elements

Source: https://docs.pdfsharp.net/PDFsharp/Topics/PDF-Features/Accessibility.html

Shows how to use BeginElement and End calls to define structure elements. Note the trailing blank in "Line one " to ensure screen readers correctly separate words.

```csharp
// Start an Article structure element.
sb.BeginElement(PdfGroupingElementTag.Article);
{
    // Create a Page and an XGraphics object as usual.
    var page = document.AddPage();
    var gfx = XGraphics.FromPdfPage(page);

    // Start a Heading1 structure element.
    sb.BeginElement(PdfBlockLevelElementTag.Heading1);
    {
        gfx.DrawString("Header Text", fontH1, XBrushes.DarkBlue, 50, 100);
    }
    // End the Heading1 element.
    sb.End();

    // Start a Paragraph structure element.
    sb.BeginElement(PdfBlockLevelElementTag.Paragraph);
    {
        // This string contains a trailing space needed for screen readers.
        gfx.DrawString("Line one ", font, XBrushes.DarkBlue, 50, 200);
        gfx.DrawString("Line two", font, XBrushes.DarkBlue, 50, 250);
    }
    // End the Paragraph structure element.
    sb.End();
}
// End the Article structure element.
sb.End();

```

--------------------------------

### Start FTP command line tool

Source: https://docs.pdfsharp.net/General/Issue-Reporting/FTP-uploads.html

Opens the FTP command line tool to connect to the PDFsharp FTP server. The tool will prompt for a user name (enter 'anonymous') and a password (typically your email address).

```text
ftp ftp.pdfsharp.net

```

--------------------------------

### Create a document with multiple headings and sections

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Document/DocumentStructure.html

Shows a complete example of adding sections and headings of levels 1 to 3 using the predefined heading styles. It demonstrates the recommended logical order of headings to avoid document outline issues.

```csharp
// Add a first section for "Heading 1" to the document.
var section1 = document.AddSection();

// Add a heading of level 1 to the first section.
var headingChapter1 = section1.AddParagraph("Heading of chapter 1");
headingChapter1.Style = StyleNames.Heading1;

// Add content of chapter 1.
var paragraphChapter1 = section1.AddParagraph("Content of chapter 1");

// Add a heading of level 2.
var headingChapter1_1 = section1.AddParagraph("Heading of chapter 1.1");
headingChapter1_1.Style = StyleNames.Heading2;

// Add content of chapter 1.1.
var paragraphChapter1_1 = section1.AddParagraph("Content of chapter 1.1");

// Add another heading of level 2.
var headingChapter1_2 = section1.AddParagraph("Heading of chapter 1.2");
headingChapter1_2.Style = StyleNames.Heading2;

// Add content of chapter 1.2. 
var paragraphChapter1_2 = section1.AddParagraph("Content of chapter 1.2");

// Add a heading of level 3.
var headingChapter1_2_1 = section1.AddParagraph("Heading of chapter 1.2.1");
headingChapter1_2_1.Style = StyleNames.Heading3;

// Add content of chapter 1.2.1.
var paragraphChapter1_2_1 = section1.AddParagraph("Content of chapter 1.2.1");

// Add a second section for the next chapters to the document.
var section2 = document.AddSection();

// Add another heading of level 1 to the second section.
var headingChapter2 = section2.AddParagraph("Heading of chapter 2");
headingChapter2.Style = StyleNames.Heading1;

// Add content of chapter 2.
var paragraphChapter2 = section2.AddParagraph("Content of chapter 2");

```

--------------------------------

### Set SectionStart to BreakOddPage

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Document/PageControl.html

Configures a section to start on an odd page. An empty page is inserted if needed to fulfill this requirement.

```csharp
section.PageSetup.SectionStart = BreakType.BreakOddPage;
```

--------------------------------

### Create a new MigraDoc document

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Document/DocumentStructure.html

Creates a new MigraDoc document using the Document constructor. This is the starting point for building a document with the MigraDoc DOM.

```csharp
// Create a new MigraDoc document.
var document = new Document();

```

--------------------------------

### Scale image with ScaleWidth and ScaleHeight

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Contents/Images.html

Sets the scale factors for width and height. The values are multiplied with the Width or Height value. This example scales the width by 2 and the height by 0.5.

```csharp
image.ScaleWidth = 2;
image.ScaleHeight = 0.5;

```

--------------------------------

### Modify default styles with new base style

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Document/Formatting.html

Shows how to add a new style layer for headings and set Heading1 to inherit from it. The example sets bold for all heading styles and changes Heading1's font size to 20pt.

```csharp
const string headingBaseStyleName = "Heading";

// Set bold for all heading styles on new style layer.
var style = document.AddStyle(headingBaseStyleName, StyleNames.Normal);
style.Font.Bold = true;

// Change Heading1 to inherit from the new style layer.
style = document.Styles[StyleNames.Heading1];
style.BaseStyle = headingBaseStyleName;
style.Font.Size = Unit.FromPoint(20);

```

--------------------------------

### Add page break to start table of contents

Source: https://docs.pdfsharp.net/MigraDoc/Topics/Start/HelloMigraDoc.html

Gets the last section of the document and adds a page break to end the cover page and start the table of contents on a new page.

```csharp
var section = document.LastSection;
section.AddPageBreak();

```

--------------------------------

### Initialize a Git repository for a ZIP download

Source: https://docs.pdfsharp.net/General/Overview/Build-PDFsharp.html

Create a local Git repository with at least one commit so the build script works when using a ZIP file from GitHub. After this, dotnet build should work and the version will be 0.1.0.

```bash
git init
git config --local user.email "you@example.com"
git config --local user.name "Your Name"
git add .
git commit -m "Init"

```

--------------------------------

### Set up a logger factory with PDFsharp filter and console output

Source: https://docs.pdfsharp.net/PDFsharp/Topics/Logging.html

Create and set a logger factory at application startup to enable logging for PDFsharp. The example filters for the 'PDFsharp' category at Information level and adds a console logger. The factory must not be disposed before the application ends; in ASP.NET, use a factory with the application host's lifetime.

```csharp
static void Main(…)
{
    // Create and set a logger factory.
    using var loggerFactory = LoggerFactory.Create(builder =>
    {
        builder
            .AddFilter("PDFsharp", LogLevel.Information)
            .AddConsole();
    });
    // Set the logger factory.
    LogHost.Factory = loggerFactory;

    // Create your PDF document with PDFsharp.
    …
}

```

--------------------------------

### SetEdge method: Set a border surrounding B2 to C3

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Formats/BordersAndLineFormat.html

Use the SetEdge method on a Table object to set a border around a rectangular area. Pass the start column and row indexes, the count of columns and rows, the Edge enum value, and the border style, width, and color. This example sets a red dotted border of 3 points around cells B2 to C3.

```csharp
// Set a border surrounding B2 to C3.
table.SetEdge(1, 1, 2, 2, Edge.Box, BorderStyle.Dot, Unit.FromPoint(3), Colors.Red);

```

--------------------------------

### Get UAManager for PDF/UA document

Source: https://docs.pdfsharp.net/PDFsharp/Topics/PDF-Features/Accessibility.html

Call UAManager.ForDocument(pdfDocument) to get the UAManager for the document, creating it if necessary. This must be done before any other operation on the document, such as creating a page. Subsequent calls return the same UAManager instance.

```csharp
// Get the UAManager for the document and create it, if necessary.
var uaManager = UAManager.ForDocument(pdfDocument);

```

--------------------------------

### MDDDL Image Definition

Source: https://docs.pdfsharp.net/MigraDoc/Overview/GrammarByExample.html

An example of defining an image with a specific height using MDDDL syntax.

```text
\image("logo_e.gif")[Height = "1cm"]
```

--------------------------------

### Add an image to the section

Source: https://docs.pdfsharp.net/MigraDoc/Topics/Start/HelloWorld.html

Gets the path to the MigraDoc logo image and adds it to the last section of the document.

```csharp
// Add MigraDoc logo.
string imagePath = IOUtility.GetAssetsPath(@"migradoc/images/MigraDoc-128x128.png")!;
document.LastSection.AddImage(imagePath);

```

--------------------------------

### Call AddFootnote

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Contents/Footnotes.html

Example call to AddFootnote to add a footnote to a section with referenceId 1 and the given bookmarkPrefix.

```csharp
// Add the footnote and its text.
AddFootnote(section, 1, bookmarkPrefix, "X must be a value between 1 and 10.");
```

--------------------------------

### Set WrapStyle to Through

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Formats/SizingAndPositioning.html

Sets the WrapFormat.Style property to WrapStyle.Through so that following content can flow at the same vertical position instead of starting below the image.

```csharp
// Set WrapStyle to Through, as the next content shall not start below it,
// but at the same vertical position.
image.WrapFormat.Style = WrapStyle.Through;

```

--------------------------------

### Set SectionStart to BreakEvenPage

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Document/PageControl.html

Configures a section to start on an even page. An empty page is inserted if needed to fulfill this requirement.

```csharp
section.PageSetup.SectionStart = BreakType.BreakEvenPage;
```

--------------------------------

### Create a simple header

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Contents/HeadersAndFooters.html

Sets up a primary header for a section and adds a paragraph with the text 'Test document'. This is the basic way to add a header.

```csharp
// Set up header.
var header = section.Headers.Primary;
header.AddParagraph("Test document");

```

--------------------------------

### Upload file using FTP commands

Source: https://docs.pdfsharp.net/General/Issue-Reporting/FTP-uploads.html

Commands to upload a file to the incoming folder on the FTP server. Use 'binary' to set binary mode, 'cd incoming' to change to the incoming directory, and 'put' to upload the file. Check that the upload succeeds and reports the correct file size.

```text
binary
cd incoming
put MigraDocRenderingIssue.zip

```

--------------------------------

### Set styles and use inheritance in MigraDoc

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Document/Formatting.html

Sets up Normal, Heading1, and Heading2 styles, then creates paragraphs and formatted text to show how properties are inherited and overridden. Comments in the code explain each inherited or overridden value. The example uses Unit.FromPoint for sizes and Colors for text color.

```csharp
// Set and use styles and direct formatting to show, how inheritance works.
// Overridden and inherited values are explained for each style and document object in the following comments.

// Set Normal style.
var style = document.Styles[StyleNames.Normal];
style.Font.Name = "Times New Roman";
style.Font.Size = Unit.FromPoint(12);

// Set Heading1 style.
style = document.Styles[StyleNames.Heading1];
style.Font.Size = Unit.FromPoint(20); 
style.Font.Bold = true;
style.ParagraphFormat.SpaceBefore = Unit.FromPoint(20); // Overrides 'Unit.FromPoint(12)' from Normal.
// 'Font.Name = "Times New Roman"' will be inherited from Normal.

// Set Heading2 style.
style = document.Styles[StyleNames.Heading2];
style.Font.Size = Unit.FromPoint(18); // Overrides 'Unit.FromPoint(20)' from Heading1.
style.Font.Italic = true;
style.ParagraphFormat.SpaceBefore = Unit.FromPoint(10); // Overrides 'Unit.FromPoint(20)' from Heading1.
style.ParagraphFormat.SpaceAfter = Unit.FromPoint(10);
// 'Font.Bold = true' will be inherited from Heading1.
// 'Font.Name = "Times New Roman"' will be inherited from Heading1 > Normal.

…

section.AddParagraph("Example for inheritance.");
// 'Font.Name = "Times New Roman"' will be inherited from Normal.
// 'Font.Size = Unit.FromPoint(12)' will be inherited from Normal.

var paragraph1 = section.AddParagraph("Heading 1: ");
paragraph1.Style = StyleNames.Heading1;
paragraph1.Format.Font.Underline = Underline.Single;
// 'Font.Size = Unit.FromPoint(20)' will be inherited from Heading1.
// 'Font.Bold = true' will be inherited from Heading1.
// 'ParagraphFormat.SpaceBefore = Unit.FromPoint(20)' will be inherited from Heading1.
// 'Font.Name = "Times New Roman"' will be inherited from Heading1 > Normal.

var formattedText1 = paragraph1.AddFormattedText("Red");
formattedText1.Color = Colors.Red;
formattedText1.Bold = false; // Overrides 'true' from paragraph1 > Heading1.
// 'Font.Underline' = will be inherited from paragraph1.
// 'Font.Size = Unit.FromPoint(20)' will be inherited from paragraph1 > Heading1.
// 'ParagraphFormat.SpaceBefore = Unit.FromPoint(20)' from paragraph1 > Heading1 is not relevant for formattedText1.
// 'Font.Name = "Times New Roman"' will be inherited from paragraph1 > Heading1 > Normal.

var paragraph2 = section.AddParagraph("Heading 2: ");
paragraph2.Style = StyleNames.Heading2;
// 'Font.Size = Unit.FromPoint(18)' will be inherited from Heading2.
// 'Font.Italic = true' will be inherited from Heading2.
// 'ParagraphFormat.SpaceBefore = Unit.FromPoint(10)' will be inherited from Heading2.
// 'ParagraphFormat.SpaceAfter = Unit.FromPoint(10)' will be inherited from Heading2.
// 'Font.Bold = true' will be inherited from Heading2 > Heading1.
// 'Font.Name = "Times New Roman"' will be inherited from Heading2 > Heading1 > Normal.

var formattedText2 = paragraph2.AddFormattedText("Blue");
formattedText2.Color = Colors.Blue;
formattedText2.Italic = false; // Overrides 'true' from paragraph2 > Heading2.
// 'Font.Size = Unit.FromPoint(18)' will be inherited from Heading2.
// 'ParagraphFormat.SpaceBefore = Unit.FromPoint(10)' from Heading2 is not relevant for formattedText2.
// 'ParagraphFormat.SpaceAfter = Unit.FromPoint(10)' from Heading2 is not relevant for formattedText2.
// 'Font.Bold = true' will be inherited from Heading2 > Heading1.
// 'Font.Name = "Times New Roman"' will be inherited from Heading2 > Heading1 > Normal.

var paragraph3 = section.AddParagraph("Whole text in ");
paragraph3.Style = StyleNames.Normal;
paragraph3.Format.Font.Color = Colors.Green;
// 'Font.Name = "Times New Roman"' will be inherited from Normal.
// 'Font.Size = Unit.FromPoint(12)' will be inherited from Normal.

var formattedText3 = paragraph3.AddFormattedText("green");
formattedText3.Bold = true;
// 'Font.Color = Colors.Green' will be inherited from paragraph3.
// 'Font.Name = "Times New Roman"' will be inherited from Normal.
// 'Font.Size = Unit.FromPoint(12)' will be inherited from Normal.

```

--------------------------------

### Set up first page header and footer

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Contents/HeadersAndFooters.html

Enables different first page headers and footers, sets up a first page header with a long title, and a first page footer without a page number.

```csharp
// Use the FirstPage header and footer.
section.PageSetup.DifferentFirstPageHeaderFooter = true;
…
// Set up first page header with long document title.
header = section.Headers.FirstPage;
header.AddParagraph("The Test document");
…
// Set up first page footer without page number.
footer = section.Footers.FirstPage;
footer.AddParagraph("\tSection one");

```

--------------------------------

### Get UAManager for PDF/A tagged PDF

Source: https://docs.pdfsharp.net/PDFsharp/Topics/PDF-Features/Archiving.html

Create a UAManager for the document to enable tagged PDF creation, required for PDF/A and PDF/UA.

```csharp
// Get the manager for universal accessibility.
var uaManager = UAManager.ForDocument(document);
```

--------------------------------

### Create an Artifact with sb.BeginArtifact()

Source: https://docs.pdfsharp.net/PDFsharp/Topics/PDF-Features/Accessibility.html

Wraps drawing operations in an artifact structure element so screen readers ignore the content. Use for decorative text, paths, or images that are not part of the document's meaning.

```csharp
// Create an Artifact.
sb.BeginArtifact();
{
    // This text is, as it is included in the artifact, not handled as actual content
    // of the document. A screen reader will skip this text.
    gfx.DrawString("An artifact", font, XBrushes.Gray, 50, 150);
}
// End the Artifact.
sb.End();

```

--------------------------------

### Demonstrate style inheritance with direct formatting in MigraDoc

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Document/Formatting.html

Sets up Normal, Heading1, and Heading2 styles, then adds paragraphs with direct formatting overrides to show how inheritance and direct formatting interact. Direct properties on objects take priority over style settings.

```csharp
// Set and use styles and direct formatting to show, how inheritance works.

// Set Normal style.
var style = document.Styles[StyleNames.Normal];
style.Font.Name = "Times New Roman";
style.Font.Size = Unit.FromPoint(12);

// Set Heading1 style.
style = document.Styles[StyleNames.Heading1];
style.Font.Size = Unit.FromPoint(20); 
style.Font.Bold = true;
style.ParagraphFormat.SpaceBefore = Unit.FromPoint(20);

// Set Heading2 style.
style = document.Styles[StyleNames.Heading2];
style.Font.Size = Unit.FromPoint(18);
style.Font.Italic = true;
style.ParagraphFormat.SpaceBefore = Unit.FromPoint(10);
style.ParagraphFormat.SpaceAfter = Unit.FromPoint(10);

…

section.AddParagraph("Example for inheritance.");

var paragraph1 = section.AddParagraph("Heading 1: ");
paragraph1.Style = StyleNames.Heading1;
paragraph1.Format.Font.Underline = Underline.Single;

var formattedText1 = paragraph1.AddFormattedText("Red");
formattedText1.Color = Colors.Red;
formattedText1.Bold = false;

var paragraph2 = section.AddParagraph("Heading 2: ");
paragraph2.Style = StyleNames.Heading2;

var formattedText2 = paragraph2.AddFormattedText("Blue");
formattedText2.Color = Colors.Blue;
formattedText2.Italic = false;

var paragraph3 = section.AddParagraph("Whole text in ");
paragraph3.Style = StyleNames.Normal;
paragraph3.Format.Font.Color = Colors.Green;

var formattedText3 = paragraph3.AddFormattedText("green");
formattedText3.Bold = true;
```

--------------------------------

### Set a custom version number with a Git tag

Source: https://docs.pdfsharp.net/General/Overview/Build-PDFsharp.html

Add a tag to set a different version number than the default 0.1.0. The example uses v6.2.0.

```bash
git tag v6.2.0

```

--------------------------------

### Create a Unit using static methods

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Formats/Unit.html

Use static methods like FromCentimeter to create a Unit instance for a specific measure.

```csharp
format.LeftIndent = Unit.FromCentimeter(1);
```

--------------------------------

### Save PDF to byte array using MemoryStream

Source: https://docs.pdfsharp.net/General/Overview/FAQ.html

Shows how to save a PdfDocument to a MemoryStream and get a byte[] using the Save method with the closeStream parameter set to false.

```csharp
MemoryStream stream = new MemoryStream();
document.Save(stream, false);
byte[] bytes = stream.ToArray();

```

--------------------------------

### Create a simple table with borders and shading

Source: https://docs.pdfsharp.net/MigraDoc/Topics/Start/HelloMigraDoc.html

Adds a table with two columns and three rows to the document. Sets a border width of 0.75 point, adds columns with widths of 2 and 5 centimeters, centers the first column's alignment, adds a shaded heading row, and applies a box border to the entire table using SetEdge.

```csharp
document.LastSection.AddParagraph("Simple Tables", StyleNames.Heading2);

var table = new Table
{
    Borders =
    {
        Width = 0.75
    }
};

var column = table.AddColumn(Unit.FromCentimeter(2));
column.Format.Alignment = ParagraphAlignment.Center;

table.AddColumn(Unit.FromCentimeter(5));

var row = table.AddRow();
row.Shading.Color = Colors.PaleGoldenrod;
row.HeadingFormat = true;
var cell = row.Cells[0];
cell.AddParagraph("Itemus");
cell = row.Cells[1];
cell.AddParagraph("Descriptum");

row = table.AddRow();
cell = row.Cells[0];
cell.AddParagraph("1");
cell = row.Cells[1];
cell.AddParagraph(FillerText.ShortText);

row = table.AddRow();
cell = row.Cells[0];
cell.AddParagraph("2");
cell = row.Cells[1];
cell.AddParagraph(FillerText.Text);

table.SetEdge(0, 0, 2, 3, Edge.Box, BorderStyle.Single, 1.5, Colors.Black);

document.LastSection.Add(table);
```

--------------------------------

### Bold text in a paragraph with AddFormattedText

Source: https://docs.pdfsharp.net/MigraDoc/Overview/FAQ.html

Use AddFormattedText with TextFormat.Bold to mix styles within a paragraph. The example adds regular text first, then appends bold text.

```csharp
var paragraph = section.AddParagraph("This is regular text. "); 

paragraph.AddFormattedText("Text in Bold style.", TextFormat.Bold); 

```

--------------------------------

### C# Image Implementation with Object Initializers

Source: https://docs.pdfsharp.net/MigraDoc/Overview/GrammarByExample.html

An alternative C# implementation using object initializers for cleaner syntax.

```csharp
var image = new Image("logo_e.gif")
{
    Height = "1cm"
};
```

--------------------------------

### Set Shading for a Table Area with SetShading

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Formats/ShadingAndFillFormat.html

Uses the Table.SetShading method to color a rectangular area of cells. Pass the start column and row indexes, the count of columns and rows, and the color.

```csharp
// Set a shading for B2 to C3.
table.SetShading(1, 1, 2, 2, Colors.Cyan);

```

--------------------------------

### Download assets for both repositories

Source: https://docs.pdfsharp.net/General/Overview/Build-PDFsharp.html

Run this PowerShell script in each repository root directory to download the required assets as described in the download assets article.

```powershell
.\dev\download-assets.ps1

```

--------------------------------

### Clear inherited footer with empty HeaderFooter

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Contents/HeadersAndFooters.html

Assign a new empty HeaderFooter to section.Footers.Primary to overwrite the footer inherited from the previous section. This is necessary when you want to start with no footer in the current section.

```csharp
// If no footer is set here, the footer will be copied from the previous section.
// Overwrite the inherited footer with an empty one.
section.Footers.Primary = new HeaderFooter();

```

--------------------------------

### Open PDF file with Process.Start (old .NET Framework)

Source: https://docs.pdfsharp.net/General/Overview/Upgrade-to-PDFsharp-6.html

Old PDFsharp samples use this simple code to open a PDF file in a PDF viewer. This works under .NET Framework but not under .NET.

```csharp
    Process.Start(filename);

```

--------------------------------

### Table.SetEdge Method

Source: https://docs.pdfsharp.net/MigraDoc/DOM/Formats/BordersAndLineFormat.html

Sets the borders of a rectangular area within a table by specifying the start column and row, the count of columns and rows, the Edge enum value, and the border style, width, and color.

```APIDOC
## Table.SetEdge Method

### Description
Sets the borders of a rectangular area within a table by specifying the start column and row, the count of columns and rows, the Edge enum value, and the border style, width, and color.

### Method
SetEdge

### Signature
`table.SetEdge(startColumn, startRow, columnCount, rowCount, edge, borderStyle, borderWidth, borderColor)`

### Parameters
- **startColumn** (int) - Required - The index of the start column.
- **startRow** (int) - Required - The index of the start row.
- **columnCount** (int) - Required - The number of columns in the area.
- **rowCount** (int) - Required - The number of rows in the area.
- **edge** (Edge) - Required - The Edge enum value defining which borders to draw.
- **borderStyle** (BorderStyle) - Required - The style of the border (e.g., BorderStyle.Dot).
- **borderWidth** (Unit) - Required - The width of the border (e.g., Unit.FromPoint(3)).
- **borderColor** (Color) - Required - The color of the border (e.g., Colors.Red).

### Example
```csharp
// Set a border surrounding B2 to C3.
table.SetEdge(1, 1, 2, 2, Edge.Box, BorderStyle.Dot, Unit.FromPoint(3), Colors.Red);
```

### Edge Enum Values
- **Top** - Includes only the top border at the edge of the area.
- **Right** - Includes only the right border at the edge of the area.
- **Bottom** - Includes only the bottom border at the edge of the area.
- **Left** - Includes only the left border at the edge of the area.
- **Horizontal** - Includes only the horizontal inner borders of the area.
- **Vertical** - Includes only the vertical inner borders of the area.
- **DiagonalDown** - Includes only the diagonal down borders in all cells of the area.
- **DiagonalUp** - Includes only the diagonal up borders in all cells of the area.
- **Box** - Includes only the borders surrounding the area.
- **Interior** - Includes only the horizontal and vertical inner borders of the area.
- **Cross** - Includes only both diagonal borders in all cells of the area.
```

--------------------------------

### Create MigraDoc document and add a section

Source: https://docs.pdfsharp.net/MigraDoc/Topics/Start/HelloWorld.html

Initializes a new MigraDoc Document and adds a section to it. All document content is organized in sections.

```csharp
// Create a new MigraDoc document.
var document = new Document();

// Add a section to the document.
var section = document.AddSection();

```
Tokens:
Raw