Hinzufügen oder Aktualisieren von Hyperlinks in PDF mit C# .NET

PDF ist ein funktionsreiches Dokumentformat, das eine Reihe von Elementen unterstützt, darunter Anmerkungen, Medien, Formulare usw. Hyperlink ist ein wichtiges Element, das verwendet wird, um innerhalb des PDFs von einem PDF zum anderen zu navigieren Webseite usw. Beim programmgesteuerten Generieren der PDF-Dokumente müssen Sie möglicherweise häufig Hyperlinks einfügen. Dementsprechend erfahren Sie in diesem Artikel, wie Sie Hyperlinks in PDF-Dateien in C# .NET hinzufügen und aktualisieren.

Um Hyperlinks in PDF-Dateien zu manipulieren, verwenden wir Aspose.PDF for .NET. Es ist eine beliebte API, mit der Sie PDF-Dateien aus .NET-Anwendungen heraus erstellen, verarbeiten und konvertieren können. Sie können die Binärdateien der API herunterladen oder sie mit NuGet installieren.

PM> Install-Package Aspose.PDF

Im Folgenden finden Sie die Schritte zum Hinzufügen eines Hyperlinks zu einer PDF-Datei in C#.

Das folgende Codebeispiel zeigt, wie Sie einen Hyperlink in PDF in C# hinzufügen.

// Dokument öffnen
Document document = new Document("input.pdf");
            
// Holen Sie sich die Referenz der Seite
var page = document.Pages[1];
            
// Link-Anmerkungsobjekt erstellen
LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300));
            
// Rahmenobjekt für LinkAnnotation erstellen
Border border = new Border(link);
            
// Legen Sie den Rahmenbreitenwert auf 0 fest
border.Width = 0;
            
// Legen Sie den Rahmen für LinkAnnotation fest
link.Border = border;
            
// Geben Sie den Linktyp als Remote-URI an
link.Action = new GoToURIAction("www.aspose.com");
            
// Link-Anmerkung zur Anmerkungssammlung der ersten Seite der PDF-Datei hinzufügen
page.Annotations.Add(link);

// Aktualisiertes Dokument speichern
document.Save("output.pdf");

Sie können auch über einen Hyperlink von einer PDF-Datei zu einer externen PDF-Datei navigieren. Die folgenden Schritte veranschaulichen, wie Sie einen Hyperlink zu einer externen PDF-Datei in C# hinzufügen.

Das folgende Codebeispiel zeigt, wie ein Hyperlink zu einer externen PDF-Datei in C# hinzugefügt wird.

// Dokument öffnen
Document document = new Document("input.pdf");

// Holen Sie sich die Referenz der Seite
var page = document.Pages[1];

// Hyperlinks erstellen
LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300));
link.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green);

// Aktion einstellen
link.Action = new GoToRemoteAction("external.pdf", 1);

// Hyperlink zur Seite hinzufügen
page.Annotations.Add(link);

// Aktualisiertes Dokument speichern
document.Save("output.pdf");

Hyperlink zu einer bestimmten PDF-Seite einfügen

In bestimmten Fällen müssen Sie innerhalb eines PDF-Dokuments von einer Seite zur anderen navigieren. Die Klasse LocalHyperlink wird verwendet, um zu einer bestimmten Seite in einem PDF zu navigieren. Im Folgenden sind die Schritte aufgeführt, um dies zu erreichen.

Das folgende Codebeispiel zeigt, wie Sie einen Hyperlink hinzufügen, um zu einer bestimmten Seite in PDF zu navigieren.

// Dokument öffnen
Document document = new Document("input.pdf");

// Holen Sie sich die Referenz der Seite
var page = document.Pages[1];

// TextFragment-Instanz erstellen
Aspose.Pdf.Text.TextFragment text = new Aspose.Pdf.Text.TextFragment("link page number test to page 7");
            
// Erstellen Sie eine lokale Hyperlinkinstanz
Aspose.Pdf.LocalHyperlink link = new Aspose.Pdf.LocalHyperlink();
            
// Zielseite für Linkinstanz festlegen
link.TargetPageNumber = 7;
            
// TextFragment-Hyperlink festlegen
text.Hyperlink = link;
            
// Fügen Sie der Absatzsammlung von Page Text hinzu
page.Paragraphs.Add(text);

// Aktualisiertes Dokument speichern
document.Save("output.pdf");

Sie können auch einen Hyperlink in einer PDF-Datei abrufen und seine Eigenschaften aktualisieren. Im Folgenden sind die Schritte zum Ausführen dieses Vorgangs aufgeführt.

  • Laden Sie die PDF-Datei mit der Klasse Document.
  • Abrufen der Referenz der Seite, auf der sich der Hyperlink befindet, aus der Document.Pages-Sammlung.
  • Extrahieren Sie das gewünschte LinkAnnotation-Objekt aus der Page.Annotations-Sammlung nach Index.
  • Aktualisieren Sie die erforderlichen Eigenschaften und speichern Sie die PDF-Datei mit der Methode Document.Save(String).

Das folgende Codebeispiel zeigt, wie Sie einen Hyperlink in PDF mit C# aktualisieren.

// Dokument öffnen
Document document = new Document("input.pdf");];

// Holen Sie sich die erste Link-Anmerkung von der ersten Seite des Dokuments
LinkAnnotation linkAnnot = (LinkAnnotation)document.Pages[1].Annotations[1];
            
// Ändern Sie die Link-Aktion und legen Sie das Ziel als Webadresse fest
linkAnnot.Action = new GoToURIAction("www.aspose.com");

// Ändern Sie andere Eigenschaften nach Bedarf

// Aktualisiertes Dokument speichern
document.Save("output.pdf");

Holen Sie sich eine kostenlose Lizenz

Sie können eine kostenlose temporäre Lizenz erhalten, um Aspose.PDF für .NET ohne Evaluierungseinschränkungen zu verwenden.

Fazit

In diesem Artikel haben Sie gelernt, wie Sie verschiedene Arten von Hyperlinks in PDF-Dateien mit C# hinzufügen. Außerdem haben Sie gesehen, wie Sie die Hyperlinks aus vorhandenen PDF-Dateien abrufen und ihre Eigenschaften programmgesteuert aktualisieren. Darüber hinaus können Sie mithilfe der Dokumentation mehr über die .NET PDF-API erfahren. Falls Sie Fragen oder Anregungen haben, können Sie uns über unser Forum kontaktieren.

Siehe auch