Agregue hipervínculos y marcadores dinámicamente usando C#

Los hipervínculos y los marcadores son útiles para que los usuarios naveguen rápidamente por el contenido relevante. Cuando hacemos clic en un hipervínculo, abre la URL en el navegador o navega a la ubicación de marcador especificada dentro del documento. En este artículo, aprenderemos cómo agregar hipervínculos y marcadores a los informes de forma dinámica mediante C#.

En este artículo se tratarán los siguientes temas:

Para agregar hipervínculos y marcadores a los informes de forma dinámica, utilizaremos la API GroupDocs.Assembly para .NET. Le permite crear potentes aplicaciones de generación de informes y automatización de documentos. Obtiene datos de la fuente de datos según el documento de plantilla definido, los ensambla y genera informes en el formato de salida especificado. Descargue la DLL de la API o instálela usando NuGet.

PM> Install-Package GroupDocs.Assembly

Podemos insertar hipervínculos en los informes de forma dinámica utilizando etiquetas de enlace. Podemos usar la etiqueta de enlace en el documento de plantilla como se muestra a continuación:

<<link [uri_expression][display_text_expression]>>

La uriexpression define el URI para un hipervínculo, mientras que la displaytextexpression define el texto que se mostrará para el hipervínculo.

Podemos insertar hipervínculos a los informes de forma dinámica siguiendo los pasos que se detallan a continuación:

  1. Cree una instancia de la clase DocumentAssembler.
  2. Llame al método AssembleDocument() para ensamblar el documento. Toma la ruta de la plantilla del documento de origen, la ruta del documento de destino y la fuente de datos como argumentos.

El siguiente ejemplo de código muestra cómo agregar hipervínculos dinámicamente mediante C#.

// Este ejemplo de código muestra cómo agregar hipervínculos dinámicamente.
// Configuración de la fuente 
const string strDocumentTemplate = @"D:\Files\Assembly\Insertinghyperlink.docx";

// Configuración de destino 
const string strDocumentReport = @"D:\Files\Assembly\Insertinghyperlink_out.docx";

// Configuración de la expresión Uri
const string uriExpression = "https://www.groupdocs.com/";

// Configuración de la expresión de texto de visualización
const string displayTextExpression = "GroupDocs";

// Instanciar la clase DocumentAssembler
DocumentAssembler assembler = new DocumentAssembler();

// Montar el documento 
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
    new DataSourceInfo(uriExpression, "uriExpression"),
    new DataSourceInfo(displayTextExpression, "displayTextExpression"));
Agregue hipervínculos dinámicamente usando C#.

Agregue hipervínculos dinámicamente usando C#.

Agregar marcadores dinámicamente usando C#

Podemos insertar marcadores en los informes de forma dinámica mediante etiquetas de marcadores. Podemos usar la etiqueta de marcador en el documento de plantilla como se muestra a continuación:

<<bookmark [bookmark_expression]>>
bookmarked_content
<</bookmark>>

La expresión de marcador define el nombre de un marcador que se va a insertar.

Podemos insertar marcadores en los informes de forma dinámica siguiendo los pasos que se indican a continuación:

  1. Cree una instancia de la clase DocumentAssembler.
  2. Llame al método AssembleDocument() para ensamblar el documento. Toma la ruta de la plantilla del documento de origen, la ruta del documento de destino y la fuente de datos como argumentos.

El siguiente ejemplo de código muestra cómo agregar marcadores dinámicamente usando C#.

// Este ejemplo de código muestra cómo agregar marcadores dinámicamente.
// Configuración de la fuente 
const string strDocumentTemplate = @"D:\Files\Assembly\Insertingbookmark.xlsx";

// Configuración de destino 
const string strDocumentReport = @"D:\Files\Assembly\Insertingbookmark_out.xlsx";

// Configuración de la expresión Uri
const String bookmark_expression = "gd_bookmark";

// Configuración de la expresión de texto de visualización
const String displayTextExpression = "GroupDocs";

// Instanciar la clase DocumentAssembler
DocumentAssembler assembler = new DocumentAssembler();

// Montar el documento 
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
    new DataSourceInfo(bookmark_expression, "bookmark_expression"),
    new DataSourceInfo(displayTextExpression, "displayTextExpression"));

También podemos vincular marcadores a hipervínculos dentro de un documento siguiendo los pasos mencionados anteriormente. Sin embargo, solo necesitamos establecer el mismo valor para uriExpression y bookmarkexpression como se muestra a continuación:

const string bookmark_expression = "gd_bookmark";
const String uriExpression = "gd_bookmark";

El siguiente ejemplo de código muestra cómo insertar un marcador como un hipervínculo mediante C#.

// Este ejemplo de código muestra cómo agregar un marcador como un hipervínculo.
// Configuración de la fuente 
const string strDocumentTemplate = @"D:\Files\Assembly\input.docx";

// Configuración de destino 
const string strDocumentReport = @"D:\Files\Assembly\output.docx";

// Configuración de la expresión Uri
const string bookmark_expression = "gd_bookmark";

// Configuración de la expresión de texto de visualización
const string displayTextExpression = "GroupDocs";

// Configuración de la expresión Uri
const String uriExpression = "gd_bookmark";

// Configuración de la expresión de texto de visualización
const String uriTextExpression = "GroupDocs";

// Instanciar la clase DocumentAssembler
DocumentAssembler assembler = new DocumentAssembler();

// Montar el documento 
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
                           new DataSourceInfo(uriExpression, "uriExpression"), 
                           new DataSourceInfo(uriTextExpression, "uriTextExpression"),
                           new DataSourceInfo(bookmark_expression, "bookmark_expression"),
                           new DataSourceInfo(displayTextExpression, "displayTextExpression"));
Insertar marcador como hipervínculo usando C#.

Insertar marcador como hipervínculo usando C#.

Obtenga una licencia gratis

Pruebe la API sin limitaciones de evaluación solicitando una licencia temporal gratuita.

Conclusión

En este artículo, hemos aprendido a:

  • insertar hipervínculos y marcadores a los informes de forma dinámica mediante C#;
  • agregue un hipervínculo a un marcador dinámicamente.

Además, puede obtener más información sobre GroupDcos.Assembly para la API de .NET utilizando la documentación. En caso de cualquier ambigüedad, no dude en contactarnos en el foro.

Ver también