Les hyperliens et les signets sont pratiques pour permettre aux utilisateurs de naviguer rapidement dans le contenu pertinent. Lorsqu’un lien hypertexte est cliqué, il ouvre l’URL dans le navigateur ou navigue jusqu’à l’emplacement du signet spécifié dans le document. Dans cet article, nous allons apprendre comment ajouter dynamiquement des liens hypertexte et des signets aux rapports à l’aide de C#.
Les sujets suivants seront traités dans cet article :
- API C # pour ajouter dynamiquement des hyperliens et des signets
- Ajouter dynamiquement des hyperliens à l’aide de C #
- Ajouter des signets dynamiquement à l’aide de C #
- Insérer un signet en tant que lien hypertexte à l’aide de C#
API C # pour ajouter dynamiquement des hyperliens et des signets
Pour ajouter dynamiquement des hyperliens et des signets aux rapports, nous utiliserons l’API GroupDocs.Assembly pour .NET. Il permet de créer de puissantes applications d’automatisation de documents et de génération de rapports. Il récupère les données de la source de données conformément au modèle de document défini, les assemble et génère des rapports dans le format de sortie spécifié. Veuillez soit télécharger la DLL de l’API ou l’installer à l’aide de NuGet.
PM> Install-Package GroupDocs.Assembly
Ajouter dynamiquement des hyperliens à l’aide de C
Nous pouvons insérer dynamiquement des hyperliens vers des rapports à l’aide des balises de lien. La syntaxe d’une balise de lien à utiliser dans le modèle de document est définie comme suit :
<<link [uri_expression][display_text_expression]>>
L’uri_expression définit l’URI d’un hyperlien, tandis que l’display_text_expression définit le texte à afficher pour l’hyperlien.
Nous pouvons insérer dynamiquement des hyperliens vers des rapports en suivant les étapes ci-dessous :
- Créez une instance de la classe DocumentAssembler.
- Appelez la méthode AssembleDocument() pour assembler le document. Il prend le chemin du modèle de document source, le chemin du document cible et la source de données comme arguments.
L’exemple de code suivant montre comment ajouter dynamiquement des liens hypertexte à l’aide de C#.
// Cet exemple de code montre comment ajouter dynamiquement des liens hypertexte.
// Configuration des sources
const string strDocumentTemplate = @"D:\Files\Assembly\Insertinghyperlink.docx";
// Configuration de la destination
const string strDocumentReport = @"D:\Files\Assembly\Insertinghyperlink_out.docx";
// Configuration de l'expression Uri
const string uriExpression = "https://www.groupdocs.com/";
// Configuration de l'expression de texte d'affichage
const string displayTextExpression = "GroupDocs";
// Instancier la classe DocumentAssembler
DocumentAssembler assembler = new DocumentAssembler();
// Assembler le document
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
new DataSourceInfo(uriExpression, "uriExpression"),
new DataSourceInfo(displayTextExpression, "displayTextExpression"));
Ajoutez dynamiquement des hyperliens à l’aide de C#.
Ajouter des signets dynamiquement à l’aide de C
Nous pouvons insérer des signets dans les rapports de manière dynamique à l’aide des balises de signet. La syntaxe d’une balise de signet à utiliser dans le modèle de document est définie comme suit :
<<bookmark [bookmark_expression]>>
bookmarked_content
<</bookmark>>
bookmark_expression définit le nom d’un signet à insérer.
Nous pouvons insérer dynamiquement des signets dans les rapports en suivant les étapes ci-dessous :
- Créez une instance de la classe DocumentAssembler.
- Appelez la méthode AssembleDocument() pour assembler le document. Il prend le chemin du modèle de document source, le chemin du document cible et la source de données comme arguments.
L’exemple de code suivant montre comment ajouter des signets dynamiquement à l’aide de C#.
// Cet exemple de code montre comment ajouter dynamiquement des signets.
// Configuration des sources
const string strDocumentTemplate = @"D:\Files\Assembly\Insertingbookmark.xlsx";
// Configuration de la destination
const string strDocumentReport = @"D:\Files\Assembly\Insertingbookmark_out.xlsx";
// Configuration de l'expression Uri
const String bookmark_expression = "gd_bookmark";
// Configuration de l'expression de texte d'affichage
const String displayTextExpression = "GroupDocs";
// Instancier la classe DocumentAssembler
DocumentAssembler assembler = new DocumentAssembler();
// Assembler le document
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
new DataSourceInfo(bookmark_expression, "bookmark_expression"),
new DataSourceInfo(displayTextExpression, "displayTextExpression"));
Insérer un signet en tant que lien hypertexte à l’aide de C
Nous pouvons également lier des signets à des hyperliens dans un document en suivant les étapes mentionnées précédemment. Cependant, nous avons juste besoin de définir la même valeur pour uriExpression et bookmark_expression comme indiqué ci-dessous :
const string bookmark_expression = "gd_bookmark";
const String uriExpression = "gd_bookmark";
L’exemple de code suivant montre comment insérer un signet en tant que lien hypertexte à l’aide de C#.
// Cet exemple de code montre comment ajouter un signet en tant que lien hypertexte.
// Configuration des sources
const string strDocumentTemplate = @"D:\Files\Assembly\input.docx";
// Configuration de la destination
const string strDocumentReport = @"D:\Files\Assembly\output.docx";
// Configuration de l'expression Uri
const string bookmark_expression = "gd_bookmark";
// Configuration de l'expression de texte d'affichage
const string displayTextExpression = "GroupDocs";
// Configuration de l'expression Uri
const String uriExpression = "gd_bookmark";
// Configuration de l'expression de texte d'affichage
const String uriTextExpression = "GroupDocs";
// Instancier la classe DocumentAssembler
DocumentAssembler assembler = new DocumentAssembler();
// Assembler le document
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
new DataSourceInfo(uriExpression, "uriExpression"),
new DataSourceInfo(uriTextExpression, "uriTextExpression"),
new DataSourceInfo(bookmark_expression, "bookmark_expression"),
new DataSourceInfo(displayTextExpression, "displayTextExpression"));
Insérer un signet en tant que lien hypertexte à l’aide de C #.
Obtenez une licence gratuite
Veuillez essayer l’API sans limitation d’évaluation en demandant une licence temporaire gratuite.
Conclusion
Dans cet article, nous avons appris à :
- insérer dynamiquement des hyperliens et des signets dans des rapports à l’aide de C# ;
- ajouter dynamiquement un lien hypertexte vers un signet.
En outre, vous pouvez en savoir plus sur l’API GroupDcos.Assembly pour .NET à l’aide de la documentation. En cas d’ambiguïté, n’hésitez pas à nous contacter sur le forum.