Un hipervínculo es un texto anclado que conduce a una página web en línea cuando se hace clic. Puede hacer que cualquier texto en un documento de Word sea un hipervínculo que navegará a los usuarios a la página vinculada cuando se haga clic. Los hipervínculos facilitan a los escritores guiar a los lectores de documentos para cualquier referencia que esté vinculada al artículo principal. Al ser un desarrollador de aplicaciones .NET, puede agregar la función de agregar hipervínculos a su aplicación de procesamiento de documentos en C#. En este artículo, pasaremos por un tutorial paso a paso para aprender sobre insertar un hipervínculo usando NPOI para .NET en C#.

Agregar hipervínculo en Word usando Microsoft Word

Antes de proceder a ver cómo insertar un hipervínculo en DOCX usando C#, echemos un vistazo a cómo se puede lograr lo mismo usando Microsoft Word.

Puede hipervínculo en un documento usando Microsoft Word como se muestra en los siguientes pasos:

  1. Seleccione el texto o la imagen que desea mostrar como hipervínculo.
  2. En la cinta, en la pestaña Insertar , seleccione Enlace . También puede hacer clic con el botón derecho en el texto o la imagen y hacer clic en el enlace****en el menú de acceso directo.
  3. En el cuadro Insertar Hyperlink , escriba o pegue su enlace en el cuadro Dirección .

¿Cómo insertar hipervínculo en el documento de Word usando C#?

Ahora que ha visto cómo insertar hipervínculos en un documento de Word usando Microsoft Word, estamos listos para ver cómo se puede lograr lo mismo usando NPOI para .NET en nuestra aplicación C#. Puede pasar por nuestra guía completa para NPOI y sus pautas de instalación en caso de que aún no la haya configurado.

Pasos para el texto de hipervínculo en el documento de Word usando C#

En esta etapa, esperamos que su aplicación de consola C# esté lista con la API NPOI agregada a ella. Use los siguientes pasos para hipervínculo del texto en el documento de Word utilizando la API NPOI en C#.

  1. Cree una instancia de XWPFDocument Clase
  2. Agregue un párrafo y un texto usando instancias de xwpfparagraph y xwpfrun
  3. Cree una instancia de hipervínculo de xwpfhyperlinkrun para el párrafo definido
  4. Use el método CreateHyperLinkrun en la instancia del párrafo para hipervínculo Puede copiar el siguiente código (tomado de NISSL Lab de GitHub) en su solicitud para probarlo.
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);
}

Conclusión

Los hipervínculos son una forma efectiva de crear enlaces entre un documento y un enlace web. Desarrolladores de aplicaciones que proporcionan la funcionalidad del procesamiento de documentos. En sus aplicaciones .NET pueden usar API NPOI para .NET para proporcionar la funcionalidad del texto de hipervilización en documentos de Word en C#. Para obtener más ejemplos de trabajar con la API NPOI en C#, estad atentos a este blog.