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:
- API de C# para agregar hipervínculos y marcadores de forma dinámica
- Agregue hipervínculos dinámicamente usando C#
- Agregar marcadores dinámicamente usando C#
- Insertar marcador como hipervínculo usando C#
API de C# para agregar hipervínculos y marcadores de forma dinámica
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
Agregue hipervínculos dinámicamente usando C#
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:
- Cree una instancia de la clase DocumentAssembler.
- 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#.
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:
- Cree una instancia de la clase DocumentAssembler.
- 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"));
Insertar marcador como hipervínculo usando C#
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#.
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.