Um hiperlink é um texto ancorado que leva a uma página da web on -line quando é clicada. Você pode fazer qualquer texto em um documento do Word um hiperlink que navegue pelos usuários para a página vinculada quando clicada. Os hiperlinks facilitam os escritores para orientar os leitores de documentos para quaisquer referências vinculadas ao artigo principal. Sendo um desenvolvedor de aplicativos .NET, você pode adicionar o recurso de adicionar hiperlinks ao aplicativo de processamento de documentos em c#. Neste artigo, passaremos por um tutorial passo a passo para aprender sobre a inserção de um hiperlink usando o NPOI para .NET em C#.

Antes de prosseguir para ver como inserir um hiperlink em docx usando C#, vamos dar uma olhada em como o mesmo pode ser alcançado usando o Microsoft Word.

Você pode hiperlink em um documento usando o Microsoft Word, como mostrado nas etapas a seguir:

  1. Selecione o texto ou a imagem que você deseja exibir como um hiperlink.
  2. Na faixa de opções, na guia Inserir , selecione link . Você também pode clicar com o botão direito do mouse no texto ou na imagem e clicar no link****no menu de atalho.
  3. Na caixa Insira o hiperlink , digite ou cola seu link na caixa de endereço****.

Agora que você viu como inserir hiperlinks em um documento do Word usando o Microsoft Word, estamos prontos para ver como o mesmo pode ser alcançado usando o NPOI para .NET em nosso aplicativo C#. Você pode passar por nosso guia abrangente para NPOI e suas diretrizes de instalação, caso ainda não o tenha configurado.

Nesta fase, esperamos que seu aplicativo de console C# esteja pronto com a API NPOI adicionada a ele. Use as etapas a seguir para hiperlink text no documento do Word usando a API NPOI em C#.

  1. Crie uma instância de xwpfdocument classe
  2. Adicione um parágrafo e texto usando instâncias de xwpfparagraph e xwpfrun
  3. Crie uma instância de hiperlink de xwpfhyperlinkrun para o parágrafo definido
  4. Use o método createHyperlinkRun na instância do parágrafo para hiperlink Você pode copiar o seguinte código (retirado do Nissl Lab do GitHub) em seu aplicativo para experimentá -lo.
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);
}

Conclusão

Os hiperlinks são uma maneira eficaz de criar links entre um documento e o link da web. Desenvolvedores de aplicativos que fornecem a funcionalidade do processamento de documentos. Em seus aplicativos .NET pode usar npoi API para .NET para fornecer a funcionalidade de texto hiperlinking em documentos do Word em C#. Para obter mais exemplos de trabalho com a API NPOI em C#, fique atento a este blog.