اضافه کردن یا به روز رسانی هایپرلینک ها در PDF با استفاده از C#.NET

PDF یک فرمت سند غنی از ویژگی است که از طیف وسیعی از عناصر از جمله حاشیه نویسی، رسانه، فرم ها و غیره پشتیبانی می کند. هایپرلینک عنصر مهمی است که برای پیمایش در PDF، از یک PDF به PDF دیگر، به یک فایل PDF استفاده می شود. صفحه وب و غیره. هنگام تولید اسناد PDF به صورت برنامه‌ریزی، ممکن است اغلب نیاز به درج لینک‌ها داشته باشید. بر همین اساس در این مقاله با نحوه افزودن و به روز رسانی هایپرلینک ها در فایل های PDF در C# .NET آشنا می شوید.

برای دستکاری لینک‌ها در فایل‌های PDF، از Aspose.PDF برای .NET استفاده می‌کنیم. این یک API محبوب است که به شما امکان می دهد فایل های PDF را از داخل برنامه های NET ایجاد، پردازش و تبدیل کنید. می توانید باینری های API را دانلود یا با استفاده از NuGet نصب کنید.

PM> Install-Package Aspose.PDF

مراحل زیر برای افزودن هایپرلینک به فایل PDF در سی شارپ آمده است.

  • با استفاده از کلاس Document یک PDF جدید ایجاد کنید یا یک فایل موجود را بارگیری کنید.
  • از مجموعه Document.Pages مرجع صفحه ای را که می خواهید لینک اضافه کنید، دریافت کنید.
  • یک شی از کلاس LinkAnnotation ایجاد کنید و ویژگی های آن را تنظیم کنید.
  • ویژگی LinkAnnotation.Action را به شیء GoToURIAction حاوی URL راه‌اندازی کنید.
  • پیوند به مجموعه Page.Annotations اضافه کنید.
  • PDF را با استفاده از روش Document.Save(String) ذخیره کنید.

نمونه کد زیر نحوه افزودن هایپرلینک به PDF در سی شارپ را نشان می دهد.

// سند را باز کنید
Document document = new Document("input.pdf");
            
// دریافت مرجع صفحه
var page = document.Pages[1];
            
// شیء حاشیه نویسی پیوند ایجاد کنید
LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300));
            
// شیء مرزی برای LinkAnnotation ایجاد کنید
Border border = new Border(link);
            
// مقدار عرض حاشیه را 0 تنظیم کنید
border.Width = 0;
            
// مرز را برای LinkAnnotation تنظیم کنید
link.Border = border;
            
// نوع پیوند را به عنوان URI راه دور مشخص کنید
link.Action = new GoToURIAction("www.aspose.com");
            
// اضافه کردن حاشیه نویسی لینک به مجموعه حاشیه نویسی صفحه اول فایل PDF
page.Annotations.Add(link);

// سند به روز شده را ذخیره کنید
document.Save("output.pdf");

همچنین می توانید با استفاده از یک لینک به یک فایل PDF خارجی از یک پی دی اف پیمایش کنید. مراحل زیر نشان می دهد که چگونه می توان یک لینک به یک فایل PDF خارجی در سی شارپ اضافه کرد.

  • با استفاده از کلاس Document یک PDF جدید ایجاد کنید یا یک فایل موجود را بارگیری کنید.
  • از مجموعه Document.Pages مرجع صفحه ای را که می خواهید لینک اضافه کنید، دریافت کنید.
  • یک شی از کلاس LinkAnnotation ایجاد کنید و ویژگی های آن را تنظیم کنید.
  • ویژگی LinkAnnotation.Action را به شیء GoToRemoteAction حاوی مسیر PDF خارجی راه اندازی کنید.
  • پیوند به مجموعه Page.Annotations اضافه کنید.
  • سند را با استفاده از روش Document.Save(String) ذخیره کنید.

نمونه کد زیر نحوه افزودن هایپرلینک به PDF خارجی در سی شارپ را نشان می دهد.

// سند را باز کنید
Document document = new Document("input.pdf");

// دریافت مرجع صفحه
var page = document.Pages[1];

// ایجاد هایپرلینک
LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300));
link.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green);

// اقدام را تنظیم کنید
link.Action = new GoToRemoteAction("external.pdf", 1);

// افزودن لینک به صفحه
page.Annotations.Add(link);

// سند به روز شده را ذخیره کنید
document.Save("output.pdf");

درج هایپرلینک به یک صفحه PDF خاص

در موارد خاص، شما باید از یک صفحه به صفحه دیگر در یک سند PDF پیمایش کنید. کلاس LocalHyperlink برای پیمایش به صفحه خاص در یک PDF استفاده می شود. مراحل زیر برای دستیابی به این مهم است.

  • با استفاده از کلاس Document یک PDF جدید ایجاد کنید یا یک فایل موجود را بارگیری کنید.
  • از مجموعه Document.Pages مرجع صفحه ای را که می خواهید لینک اضافه کنید، دریافت کنید.
  • یک نمونه از TextFragment برای تنظیم متن هایپرلینک ایجاد کنید.
  • یک نمونه از کلاس LocalHyperlink ایجاد کنید و ویژگی LocalHyperlink.TargetPageNumber را روی شماره صفحه دلخواه تنظیم کنید.
  • شیء LocalHyperlink را به ویژگی TextFragment.Hyperlink اختصاص دهید.
  • متن را با استفاده از روش Page.Paragraphs.Add(TextFragment) به صفحه اضافه کنید.
  • PDF را با استفاده از روش Document.Save(String) ذخیره کنید.

نمونه کد زیر نحوه افزودن هایپرلینک برای پیمایش به یک صفحه خاص در PDF را نشان می دهد.

// سند را باز کنید
Document document = new Document("input.pdf");

// دریافت مرجع صفحه
var page = document.Pages[1];

// نمونه TextFragment ایجاد کنید
Aspose.Pdf.Text.TextFragment text = new Aspose.Pdf.Text.TextFragment("link page number test to page 7");
            
// نمونه هایپرلینک محلی ایجاد کنید
Aspose.Pdf.LocalHyperlink link = new Aspose.Pdf.LocalHyperlink();
            
// صفحه هدف را برای نمونه پیوند تنظیم کنید
link.TargetPageNumber = 7;
            
// Hyperlink TextFragment را تنظیم کنید
text.Hyperlink = link;
            
// متن را به مجموعه پاراگراف های صفحه اضافه کنید
page.Paragraphs.Add(text);

// سند به روز شده را ذخیره کنید
document.Save("output.pdf");

همچنین می توانید یک هایپرلینک را در یک فایل PDF بازیابی کنید و ویژگی های آن را به روز کنید. مراحل زیر برای انجام این عملیات آورده شده است.

  • فایل PDF را با استفاده از کلاس Document بارگیری کنید.
  • از مجموعه Document.Pages مرجع صفحه ای را که لینک در آن قرار دارد دریافت کنید.
  • شیء مورد نظر LinkAnnotation را از مجموعه Page.Annotations بر اساس فهرست استخراج کنید.
  • ویژگی های مورد نیاز را به روز کنید و PDF را با استفاده از روش Document.Save(String) ذخیره کنید.

نمونه کد زیر نحوه به روز رسانی هایپرلینک در PDF را با استفاده از C# نشان می دهد.

// سند را باز کنید
Document document = new Document("input.pdf");];

// اولین حاشیه نویسی پیوند را از صفحه اول سند دریافت کنید
LinkAnnotation linkAnnot = (LinkAnnotation)document.Pages[1].Annotations[1];
            
// عمل پیوند را تغییر دهید و هدف را به عنوان آدرس وب تنظیم کنید
linkAnnot.Action = new GoToURIAction("www.aspose.com");

// سایر خصوصیات را در صورت لزوم تغییر دهید

// سند به روز شده را ذخیره کنید
document.Save("output.pdf");

مجوز رایگان دریافت کنید

برای استفاده از Aspose.PDF برای دات نت بدون محدودیت ارزیابی، می توانید یک مجوز موقت رایگان دریافت کنید.

نتیجه

در این مقاله یاد گرفتید که چگونه با استفاده از سی شارپ انواع هایپرلینک را در فایل های پی دی اف اضافه کنید. علاوه بر این، نحوه بازیابی لینک‌ها از فایل‌های PDF موجود و به‌روزرسانی ویژگی‌های آن‌ها را به صورت برنامه‌ریزی دیده‌اید. علاوه بر این، می‌توانید با استفاده از مستندات درباره .NET PDF API بیشتر کاوش کنید. در صورت داشتن هرگونه سوال یا سوال، می توانید از طریق [تالار گفتمان35 ما با ما تماس بگیرید.

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