Hyperlinks hinzufügen oder ändern

Ein Hyperlink in Microsoft Word-Dokumenten ist das HYPERLINK-Feld. In Aspose.Words werden Hyperlinks über die FieldHyperlink-Klasse implementiert.

Fügen Sie einen Hyperlink ein

Verwenden Sie die InsertHyperlink-Methode, um einen Hyperlink in das Dokument einzufügen. Diese Methode akzeptiert drei Parameter:

1. Text des Links, der im Dokument angezeigt werden soll
2. Linkziel (URL oder Name eines Lesezeichens im Dokument)
3. Boolescher Parameter, der true sein sollte, wenn URL der Name eines Lesezeichens in einem Dokument ist

Die InsertHyperlink-Methode fügt am Anfang und Ende der URL immer Apostrophe hinzu

Beachten Sie, dass Sie die Schriftartformatierung für den Hyperlink-Anzeigetext explizit mithilfe der Font-Eigenschaft angeben müssen.

Das folgende Codebeispiel zeigt, wie man mit DocumentBuilder einen Hyperlink in ein Dokument einfügt:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Please make sure to visit ");
builder.Font.Color = Color.Blue;
builder.Font.Underline = Underline.Single;

builder.InsertHyperlink("Aspose Website", "http://www.aspose.com", false);

builder.Font.ClearFormatting();
builder.Write(" for more information.");

doc.Save(ArtifactsDir + "AddContentUsingDocumentBuilder.InsertHyperlink.docx");

Ersetzen oder ändern Sie Hyperlinks

Hyperlink in Microsoft Word-Dokumenten ist ein Feld. Ein Feld in einem Word-Dokument ist, wie bereits erwähnt, eine komplexe Struktur, die aus mehreren Knoten besteht, die Feldanfang, Feldcode, Feldtrennzeichen, Feldergebnis und Feldende umfassen. Felder können verschachtelt sein, umfangreiche Inhalte enthalten und sich über mehrere Absätze oder Abschnitte in einem Dokument erstrecken.

Um Hyperlinks zu ersetzen oder zu ändern, müssen Sie die Hyperlinks im Dokument finden und entweder ihren Text, ihre URLs oder beides ersetzen.

Das folgende Codebeispiel zeigt, wie Sie alle Hyperlinks in einem Word-Dokument finden und deren URL- und Anzeigenamen ändern:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(MyDir + "Hyperlinks.docx");

foreach (Field field in doc.Range.Fields)
{
    if (field.Type == FieldType.FieldHyperlink)
    {
        FieldHyperlink hyperlink = (FieldHyperlink) field;

        // Some hyperlinks can be local (links to bookmarks inside the document), ignore these.
        if (hyperlink.SubAddress != null)
            continue;

        hyperlink.Address = "http://www.aspose.com";
        hyperlink.Result = "Aspose - The .NET & Java Component Publisher";
    }
}

doc.Save(ArtifactsDir + "WorkingWithFields.ReplaceHyperlinks.docx");