Aggiungi o modifica collegamenti ipertestuali

Un collegamento ipertestuale nei documenti Microsoft Word è il campo HYPERLINK. In Aspose.Words, i collegamenti ipertestuali vengono implementati tramite la classe FieldHyperlink.

Inserisci un collegamento ipertestuale

Utilizzare il metodo InsertHyperlink per inserire un collegamento ipertestuale nel documento. Questo metodo accetta tre parametri:

1. Testo del collegamento da visualizzare nel documento
2. Destinazione del collegamento (URL o nome di un segnalibro all’interno del documento)
3. Parametro booleano che dovrebbe essere true se il URL è il nome di un segnalibro all’interno di un documento

Il metodo InsertHyperlink aggiunge sempre apostrofi all’inizio e alla fine dell’URL

Tieni presente che devi specificare la formattazione del carattere per il testo visualizzato del collegamento ipertestuale utilizzando esplicitamente la proprietà Font.

L’esempio di codice seguente mostra come inserire un collegamento ipertestuale in un documento utilizzando DocumentBuilder:

// 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");

Sostituisci o modifica i collegamenti ipertestuali

Il collegamento ipertestuale nei documenti Microsoft Word è un campo. Un campo in un documento Word, come abbiamo detto prima, è una struttura complessa composta da più nodi che includono inizio campo, codice campo, separatore campo, risultato campo e fine campo. I campi possono essere nidificati, contenere contenuti avanzati e estendersi su più paragrafi o sezioni in un documento.

Per sostituire o modificare i collegamenti ipertestuali, è necessario trovare i collegamenti ipertestuali nel documento e sostituire il loro testo, gli URL o entrambi.

L’esempio di codice seguente mostra come trovare tutti i collegamenti ipertestuali nel documento di Word e modificarne il URL e il nome visualizzato:

// 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");