Un hyperlien est un texte ancré qui mène à une page Web en ligne lorsqu’elle est cliquée. Vous pouvez faire de n’importe quel texte dans un document Word un hyperlien qui naviguera dans les utilisateurs vers la page liée lors de la clic. Les hyperliens permettent aux écrivains de guider facilement les lecteurs de documents pour toutes les références liées à l’article principal. Étant un développeur d’applications .NET, vous pouvez ajouter la fonctionnalité de l’ajout d’hyperliens à votre application de traitement de document dans C #. Dans cet article, nous allons passer par un tutoriel étape par étape pour apprendre à insérer un hyperlien en utilisant NPOI pour .NET en C #.

Ajouter un lien hypertexte en mot à l’aide de Microsoft Word

Avant de voir comment insérer un hyperlien dans docx en utilisant C #, examinons comment il peut être réalisé à l’aide de Microsoft Word.

Étapes pour insérer un lien hypertexte dans le document Word à l’aide de Microsoft Word

Vous pouvez hyperlien dans un document à l’aide de Microsoft Word comme indiqué dans les étapes suivantes:

  1. Sélectionnez le texte ou l’image que vous souhaitez afficher comme hyperlien.
  2. Sur le ruban, sur l’onglet INSERT , sélectionnez Lien . Vous pouvez également cliquer avec le bouton droit sur le texte ou l’image et cliquer sur le lien****dans le menu de raccourci.
  3. Dans la zone Insérer un lien hyperlien , tapez ou collez votre lien dans la case Adresse .

Comment insérer un lien hypertexte dans le document Word à l’aide de C #?

Maintenant que vous avez vu comment insérer des hyperliens dans un document Word à l’aide de Microsoft Word, nous sommes prêts à voir comment il peut être réalisé en utilisant NPOI pour .NET dans notre application C #. Vous pouvez passer par notre guide complet pour NPOI et ses directives d’installation au cas où vous ne l’auriez pas encore configuré.

À ce stade, nous nous attendons à ce que votre application C # console soit prête avec l’API NPOI. Utilisez les étapes suivantes pour hyperlienant le texte dans un document Word à l’aide de l’API NPOI en C #.

  1. Créez une instance de la classe xwpfDocument
  2. Ajoutez un paragraphe et un texte en utilisant des instances de xwpfparagraph et xwpfrun
  3. Créez une instance hyperlienne de xwpfhyperLinkrun pour le paragraphe défini
  4. Utilisez la méthode CreateHyperLinkRun sur l’instance de paragraphe pour hyperlien Vous pouvez copier le code suivant (pris à partir de Nissl Lab à partir de GitHub) dans votre application pour l’essayer.
static void InsertHyperlink()
{
    using (XWPFDocument doc = new XWPFDocument())
    {
        XWPFParagraph paragraph = doc.CreateParagraph();
        XWPFRun run = paragraph.CreateRun();
        run.SetText("This is a text paragraph having ");
        XWPFHyperlinkRun hyperlinkrun = CreateHyperlinkRun(paragraph, "https://www.google.com");
        hyperlinkrun.SetText("a link to Google");
        hyperlinkrun.SetColor("0000FF");
        hyperlinkrun.Underline = UnderlinePatterns.Single;
        run = paragraph.CreateRun();
        run.SetText(" in it.");
        using (FileStream out1 = new FileStream("hyperlink.docx", FileMode.Create))
        {
            doc.Write(out1);
        }
    }
}
static XWPFHyperlinkRun CreateHyperlinkRun(XWPFParagraph paragraph, String uri)
{
    String rId = paragraph.Document.GetPackagePart().AddExternalRelationship(
        uri,
        XWPFRelation.HYPERLINK.Relation
        ).Id;

    return paragraph.CreateHyperlinkRun(rId);
}

Conclusion

Les hyperliens sont un moyen efficace de créer des liens entre un document et un lien Web. Développeurs d’applications qui fournissent la fonctionnalité du traitement des documents. Dans leurs applications .NET, peuvent utiliser API NPOI pour .NET pour fournir la fonctionnalité du texte hyperlisant dans des documents Word en C #. Pour plus d’exemples de travail avec l’API NPOI en C #, restez à l’écoute de ce blog.