Wie man in C#/VB.NET die Hintergrundfarbe und das Hintergrundbild von PDF-Dokumenten festlegt
Tags: csharp, vbnet, dotnet, pdf
Published: 2023-08-18 09:58:21

Eine passende Hintergrundgestaltung kann die visuelle Wirkung von PDF-Dokumenten und das Leseerlebnis verbessern, indem sie den Inhalt und verschiedene Elemente des PDF-Dokuments klarer hervorhebt. Darüber hinaus ist es für verschiedene Szenarien auch sehr wichtig, unterschiedliche Hintergründe zu PDF-Dokumenten hinzuzufügen, um den Professionalismus des Dokuments zu erhöhen. In diesem Artikel wird gezeigt, wie mit dem kostenlosen [Free Spire.PDF for Java](https://www.e-iceblue.com/Introduce/free-pdf-component.html) über ein Java-Programm die **Hintergrundfarbe und das Hintergrundbild von PDF-Dokumenten festgelegt** werden kann.

- **[Hinzufügen einer Hintergrundfarbe zu PDF-Seiten](#hinzuf%C3%BCgen-einer-hintergrundfarbe-zu-pdfseiten)**
- **[Hinzufügen eines Hintergrundbilds zu PDF-Seiten](#hinzuf%C3%BCgen-eines-hintergrundbilds-zu-pdfseiten)**

### Hinzufügen von Abhängigkeiten
Die Abhängigkeiten von Free Spire.PDF für .NET können entweder manuell von der [offiziellen Website](https://www.e-iceblue.com/Download/download-pdf-for-net-free.html) heruntergeladen oder über den NuGet-Paket-Manager gesucht oder mit dem folgenden Code über die Paket-Manager-Konsole hinzugefügt werden:

```xml
PM> Install-Package FreeSpire.PDF
```

## Hinzufügen einer Hintergrundfarbe zu PDF-Seiten
Da die Hintergrundeinstellung für PDF-Dokumente seitenweise erfolgen muss, kann man alle Seiten im Dokument durchlaufen und die Hintergrundfarbe jeder Seite mit der Eigenschaft **PdfPageBase.BackgroundColor** festlegen. Hier sind die detaillierten Schritte:

- Erstellen Sie ein **PdfDocument**-Objekt.
- Laden Sie das PDF-Dokument mit der **PdfDocument.LoadFromFile()**-Methode.
- Durchlaufen Sie die Seiten im PDF-Dokument und legen Sie für jede Seite die Hintergrundfarbe mit der **PdfPageBase.BackgroundColor**-Eigenschaft fest. Sie können auch die Undurchsichtigkeit des Hintergrunds mit der **PdfPageBase.BackgroudOpacity**-Eigenschaft festlegen.
- Speichern Sie das Dokument mit der **PdfDocument.SaveToFile()**-Methode.

**Codebeispiel**

**C#:**

```C#
using System;
using System.Drawing;
using Spire.Pdf;
using Spire.Pdf.Graphics;

class Program
{
    static void Main(string[] args)
    {
        // PdfDocument-Objekt erstellen
        PdfDocument pdf = new PdfDocument();

        // PDF-Dokument laden
        pdf.LoadFromFile("Beispiel.pdf");

        // Über die Seiten des PDF-Dokuments iterieren
        foreach (PdfPageBase page in pdf.Pages)
        {
            // Hintergrundfarbe für jede Seite festlegen
            page.BackgroundColor = Color.Pink;

            // Undurchsichtigkeit des Hintergrunds festlegen
            page.BackgroundOpacity = 0.2f;
        }

        // PDF-Dokument speichern
        pdf.SaveToFile("Hintergrundfarbe.pdf");
    }
}
```

**VB.NET:**
```vb
Imports System
Imports System.Drawing
Imports Spire.Pdf
Imports Spire.Pdf.Graphics

Module Program
    Sub Main()
        ' PdfDocument-Objekt erstellen
        Dim pdf As New PdfDocument()

        ' PDF-Dokument laden
        pdf.LoadFromFile("Beispiel.pdf")

        ' Über die Seiten des PDF-Dokuments iterieren
        For Each page As PdfPageBase In pdf.Pages
            ' Hintergrundfarbe für jede Seite festlegen
            page.BackgroundColor = Color.Pink

            ' Undurchsichtigkeit des Hintergrunds festlegen
            page.BackgroundOpacity = 0.2f
        Next

        ' PDF-Dokument speichern
        pdf.SaveToFile("Hintergrundfarbe.pdf")
    End Sub
End Module
```


![Hinzufügen einer Hintergrundfarbe zu PDF-Seiten](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/akeura59z6c2ytpyj12j.png)

## Hinzufügen eines Hintergrundbilds zu PDF-Seiten
Free Spire.PDF für .NET stellt die Eigenschaft **PdfPageBase.BackgroundImage** bereit, um ein Bild als Hintergrund von PDF-Seiten festzulegen. Hier sind die detaillierten Schritte zum Hinzufügen eines Bildhintergrunds zu einem PDF-Dokument:

- Erstellen Sie ein **PdfDocument**-Objekt.
- Laden Sie das PDF-Dokument mit der **PdfDocument.LoadFromFile()**-Methode.
- Durchlaufen Sie die Seiten im PDF-Dokument und legen Sie für jede Seite das Hintergrundbild mit der **PdfPageBase.BackgroundImage**-Eigenschaft fest. Sie können auch die Undurchsichtigkeit des Hintergrunds mit der **PdfPageBase.BackgroundOpacity**-Eigenschaft festlegen.
- Speichern Sie das Dokument mit der **PdfDocument.SaveToFile()**-Methode.

**Codebeispiel**

**C#:**
```c#
using System;
using System.Drawing;
using System.IO;
using Spire.Pdf;
using Spire.Pdf.Graphics;

class Program
{
    static void Main(string[] args)
    {
        // PdfDocument-Objekt erstellen
        PdfDocument pdf = new PdfDocument();

        // PDF-Dokument laden
        pdf.LoadFromFile("Beispiel.pdf");

        // Bild laden
        Image background = Image.FromFile("Hintergrund.jpg");

        // Über die Seiten des PDF-Dokuments iterieren
        foreach (PdfPageBase page in pdf.Pages)
        {
            // Das geladene Bild als Hintergrundbild der Seite festlegen
            page.BackgroundImage = background;

            // Undurchsichtigkeit des Hintergrunds festlegen
            page.BackgroundOpacity = 0.2f;
        }

        // PDF-Dokument speichern
        pdf.SaveToFile("Hintergrundbild.pdf");
    }
}
```

**VB.NET:**
```vb
Imports System
Imports System.Drawing
Imports System.IO
Imports Spire.Pdf
Imports Spire.Pdf.Graphics

Module Program
    Sub Main()
        ' PdfDocument-Objekt erstellen
        Dim pdf As New PdfDocument()

        ' PDF-Dokument laden
        pdf.LoadFromFile("Beispiel.pdf")

        ' Bild laden
        Dim background As Image = Image.FromFile("Hintergrund.jpg")

        ' Über die Seiten des PDF-Dokuments iterieren
        For Each page As PdfPageBase In pdf.Pages
            ' Das geladene Bild als Hintergrundbild der Seite festlegen
            page.BackgroundImage = background

            ' Undurchsichtigkeit des Hintergrunds festlegen
            page.BackgroundOpacity = 0.2f
        Next

        ' PDF-Dokument speichern
        pdf.SaveToFile("Hintergrundbild.pdf")
    End Sub
End Module
```


![Hinzufügen eines Hintergrundbilds zu PDF-Seiten](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/xq58de4ez1ucdabw0t4j.png)

> Dieser Artikel zeigt, wie man Hintergrundfarben und -bilder zu PDF-Seiten hinzufügt. Free Spire.PDF für Java bietet viele weitere PDF-Verarbeitungsfunktionen. Sehen Sie sich das [Spire.PDF für Java-Tutorial](https://www.e-iceblue.com/Tutorials/Spire.PDF/Spire.PDF-Program-Guide/Spire.PDF-Program-Guide-Content.html) für weitere Details an. Wenn Sie Probleme bei der Verwendung dieser API haben oder etwas mit anderen diskutieren möchten, besuchen Sie das [Spire.PDF-Forum](https://www.e-iceblue.com/forum/spire-pdf-f7.html).