پیوندها و نشانه‌گذاری‌ها را به‌طور پویا با استفاده از C# اضافه کنید

پیوندها و نشانک‌ها برای کاربران مفید هستند تا به سرعت به محتوای مربوطه دسترسی پیدا کنند. وقتی که ما بر روی یک پیوند کلیک می‌کنیم، URL در مرورگر باز می‌شود یا به مکان نشانک مشخص شده در داخل سند منتقل می‌شود. در این مقاله، ما یاد خواهیم گرفت که چگونه به طور دینامیک پیوندها و نشانک‌ها را به گزارش‌ها با استفاده از C# اضافه کنیم.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

• C# API برای افزودن پیوندها و نشانک‌ها به صورت دینامیک
• Hyperlinks را به صورت پویا با استفاده از C# اضافه کنید
• به صورت پویا بوکمارک‌ها را با استفاده از C# اضافه کنید
• ایجاد نشانک به عنوان پیوند با استفاده از C#

API C# برای افزودن هایپرلینک ها و بوکمارک ها به صورت پویا

برای افزودن هایپرلینک‌ها و نشانه‌گذاری‌ها به گزارش‌ها به صورت دینامیک، ما از API GroupDocs.Assembly for .NET استفاده خواهیم کرد. این API به شما امکان ساخت برنامه‌های قدرتمند اتوماسیون اسناد و تولید گزارش را می‌دهد. این API داده‌ها را از منبع داده مطابق با سند الگوی تعریف‌شده دریافت کرده، آن را مونتاژ می‌کند و گزارش‌ها را در فرمت خروجی مشخص شده تولید می‌کند. لطفا یا دانلود DLL API را انجام دهید یا آن را با استفاده از NuGet نصب کنید.

PM> Install-Package GroupDocs.Assembly
کپی

Add Hyperlinks Dynamically using C#

ما می‌توانیم به صورت داینامیک هایپرلینک‌ها را به گزارش‌ها وارد کنیم با استفاده از تگ‌های لینک. می‌توانیم از تگ لینک در سند الگو به صورت زیر استفاده کنیم:

<<link [uri_expression][display_text_expression]>>
کپی

عبارت uriexpression URI را برای یک پیوند تعریف می‌کند، در حالی که عبارت displaytextexpression متنی را که باید برای پیوند نمایش داده شود، تعریف می‌کند.

ما می‌توانیم با دنبال کردن مراحل زیر به طور پویا پیوندهای هایپرلینک به گزارش‌ها اضافه کنیم:

1. یک نمونه از کلاس DocumentAssembler را ایجاد کنید.
2. متد AssembleDocument() را برای جمع آوری سند فراخوانی کنید. این متد مسیر الگوی سند منبع، مسیر سند هدف و منبع داده را به عنوان آرگومان می‌گیرد.

نمونه کد زیر نشان می‌دهد که چگونه می‌توان به‌طور دینامیک لینک‌های هایپرلینک را با استفاده از C# اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه به‌طور داینامیک لینک‌های هایپر متصل اضافه کنیم.
// تنظیم منبع 
const string strDocumentTemplate = @"D:\Files\Assembly\Insertinghyperlink.docx";

// تنظیم مقصد 
const string strDocumentReport = @"D:\Files\Assembly\Insertinghyperlink_out.docx";

// تنظیم بیان URI
const string uriExpression = "https://www.groupdocs.com/";

// تنظیم عبارت متن نمایش
const string displayTextExpression = "GroupDocs";

// کلاس DocumentAssembler را instantiate کنید
DocumentAssembler assembler = new DocumentAssembler();

// Assemble the document 
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
    new DataSourceInfo(uriExpression, "uriExpression"),
    new DataSourceInfo(displayTextExpression, "displayTextExpression"));
کپی

کتابچه‌ها را به صورت پویا با استفاده از C# اضافه کنید

ما می‌توانیم به صورت پویا نشانک‌ها را با استفاده از برچسب‌های نشانک در گزارش‌ها وارد کنیم. ما می‌توانیم از برچسب نشانک در سند الگو به صورت زیر استفاده کنیم:

<<bookmark [bookmark_expression]>>
bookmarked_content
<</bookmark>>
کپی

عبارت bookmarkexpression نام یک بوکمارک را برای درج تعریف می‌کند.

ما می‌توانیم با دنبال کردن مراحل زیر، به طور پویا نشانه‌گذاری به گزارش‌ها اضافه کنیم:

1. یک نمونه از کلاس DocumentAssembler را ایجاد کنید.
2. متد AssembleDocument() را برای جمع آوری سند فراخوانی کنید. این متد مسیر الگوی سند منبع، مسیر سند هدف و منبع داده را به عنوان آرگومان می‌گیرد.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان به طور پویا نشانک‌ها را با استفاده از C# اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه به صورت دینامیکی نشانه‌ها را اضافه کنیم.
// تنظیم منبع 
const string strDocumentTemplate = @"D:\Files\Assembly\Insertingbookmark.xlsx";

// تنظیم مقصد 
const string strDocumentReport = @"D:\Files\Assembly\Insertingbookmark_out.xlsx";

// تنظیم عبارت Uri
const String bookmark_expression = "gd_bookmark";

// تنظیم بیان متن نمایش
const String displayTextExpression = "GroupDocs";

// کلاس DocumentAssembler را فراخوانی کنید
DocumentAssembler assembler = new DocumentAssembler();

// Assemble the document 
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
    new DataSourceInfo(bookmark_expression, "bookmark_expression"),
    new DataSourceInfo(displayTextExpression, "displayTextExpression"));
کپی

با استفاده از C# نشانه‌گذاری را به عنوان پیوند وارد کنید

ما می‌توانیم همچنین نشانه‌گذاری‌ها را به پیوندهای اینترنتی درون یک سند متصل کنیم با پیروی از مراحلی که در گذشته ذکر شد. با این حال، ما فقط نیاز داریم تا ارزش یکسانی برای uriExpression و bookmarkexpression تنظیم کنیم همان‌طور که در زیر نشان داده شده است:

const string bookmark_expression = "gd_bookmark";
const String uriExpression = "gd_bookmark";
کپی

کد نمونه زیر نشان می‌دهد که چگونه یک نشانه را به عنوان یک پیوند متنی با استفاده از C# وارد کنیم.

// این مثال کد نشان می‌دهد که چگونه می‌توان یک نشان‌گذاری به عنوان یک لینک اضافه کرد.
// تنظیم منبع 
const string strDocumentTemplate = @"D:\Files\Assembly\input.docx";

// تنظیم مقصد 
const string strDocumentReport = @"D:\Files\Assembly\output.docx";

// تنظیم بیان URI
const string bookmark_expression = "gd_bookmark";

// تنظیم عبارت نمایش متن
const string displayTextExpression = "GroupDocs";

// تنظیم بیان URI
const String uriExpression = "gd_bookmark";

// تنظیم عبارت نمایش متن
const String uriTextExpression = "GroupDocs";

// کلاس DocumentAssembler راinstantiate کنید
DocumentAssembler assembler = new DocumentAssembler();

// Assemble the document 
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
                           new DataSourceInfo(uriExpression, "uriExpression"), 
                           new DataSourceInfo(uriTextExpression, "uriTextExpression"),
                           new DataSourceInfo(bookmark_expression, "bookmark_expression"),
                           new DataSourceInfo(displayTextExpression, "displayTextExpression"));
کپی

یک مجوز رایگان بگیرید

لطفاً امتحان کنید API را بدون محدودیت های ارزیابی با درخواست یک مجوز موقت رایگان.

نتیجه گیری

در این مقاله، ما یاد گرفته‌ایم چگونه:

• گزارش‌ها را به‌طور دینامیک با استفاده از C# لینک‌ها و نشانه‌گذاری کنید؛
• add a hyperlink to a bookmark dynamically.

علاوه بر این، می‌توانید اطلاعات بیشتری در مورد GroupDcos.Assembly برای API .NET با استفاده از documentation بیاموزید. در صورت وجود هر گونه ابهام، لطفاً با خیال راحت با ما در forum تماس بگیرید.

همچنین ببینید

• از داده‌های Excel در C# گزارش‌ها تولید کنید