بسیاری از برنامهها برای افزودن متن به PDF در .NET بهمنظور حاشیهنویسی پویا به اسناد نیاز دارند. Conholdate.Total for .NET یک SDK جامع است که کار با PDF را بر روی سرور یا دسکتاپ ساده میکند. در این راهنما خواهید دید که چگونه کتابخانه را نصب کنید، یک PDF موجود را بارگذاری کنید، متن با سبکدار را وارد کنید و فایل بهروزرسانیشده را با یک مثال کد کامل و ready‑to‑run ذخیره کنید.
افزودن متن به PDF در Java – الزامات
توسعهدهندگانی که رابطهای کاربری مبتنی بر Java میسازند، اغلب به یک سرویس .NET نیاز دارند که بتواند PDFها را در سمت سرور تغییر دهد. الزامات معمول شامل موارد زیر است:
- بارگذاری یک PDF موجود بدون از دست دادن محتوای موجود.
- افزودن متن سفارشی در مختصات دقیق، با فونت و رنگ خاص.
- ذخیرهسازی PDF اصلاحشده در حالی که چیدمان و متادیتای اصلی حفظ میشود.
ویرایش دستی یا ابزارهای عمومی خط فرمان نمیتوانند این نیازها را در یک جریان کاری خودکار برآورده کنند، بهویژه زمانی که عملیات باید بهصورت برنامهنویسی برای تعداد زیادی فایل انجام شود.
انتخاب Conholdate.Total for .NET برای کار
Conholdate.Total for .NET مجموعهای غنی از APIهای PDF را ارائه میدهد که مستقیماً به نیازهای فوق میپردازند. میتواند:
- PDFها را بدون تبدیل باز کنید و ویرایش کنید.
- اشیاء
TextFragmentرا با کنترل کامل استایل ایجاد کنید. - قطعات را در هر صفحهای در موقعیتهای دقیق وارد کنید.
- نتیجه را با یک فراخوانی متد ذخیره کنید.
SDK بهصورت بسته NuGet ارائه میشود، بر روی تمام زمانهای اجرا .NET کار میکند و شامل مستندات دقیق مستندات و یک مرجع گسترده مرجع API است. میتوانید آخرین ساخت را از صفحه انتشار دانلود کنید.
راهنمای گامبهگام: افزودن متن به PDF در .NET
در ادامه یک راهنمای عملی ارائه شده است که کد نشان داده شده در مثال کامل را بازتاب میدهد.
نصب Conholdate.Total برای .NET
ابتدا، SDK را از طریق NuGet به پروژه خود اضافه کنید.
dotnet add package Conholdate.Total --version 25.10.0
همچنین میتوانید باینریها را از آدرس دانلود دریافت کنید.
بارگذاری سند PDF موجود
یک نمونه Document ایجاد کنید که به PDF منبع اشاره دارد.
using GroupDocs.Pdf;
string inputPath = "input.pdf";
// Load the existing PDF document
using (Document pdfDocument = new Document(inputPath))
{
// further processing...
}
کلاس Document بخشی از API PDF است که در مرجع API توضیح داده شده است.
ایجاد و پیکربندی بخش متن
یک TextFragment را نمونهسازی کنید، موقعیت، قلم و رنگ آن را تنظیم کنید.
using GroupDocs.Pdf.Contents;
using GroupDocs.Pdf.Contents.Text;
using GroupDocs.Pdf.Contents.Fonts;
// Create a text fragment to insert
TextFragment textFragment = new TextFragment("Added text using Conholdate.Total for .NET");
// Set visual properties
textFragment.Position = new Position(100, 150); // X and Y coordinates in points
textFragment.Font = new Font("Arial", 12);
textFragment.Color = new Color(255, 0, 0); // Red color
این گام درج متن در PDF با استفاده از کتابخانه .NET را با گزینههای کامل استایلگذاری نشان میدهد.
افزودن قطعه متن به صفحه
صفحه هدف را انتخاب کنید (در این مورد، صفحه اول) و قطعه متن را اضافه کنید.
// Ensure there is at least one page
Page page = pdfDocument.Pages.Count > 0 ? pdfDocument.Pages[0] : pdfDocument.Pages.Add();
// Add the text fragment to the page
page.Paragraphs.Add(textFragment);
میتوانید این بلوک را برای افزودن متن به فایل PDF در .NET در صفحات یا موقعیتهای متعدد تکرار کنید.
ذخیره سند PDF اصلاحشده
در نهایت، تغییرات را در یک فایل جدید بنویسید.
string outputPath = "output.pdf";
// Save the modified PDF
pdfDocument.Save(outputPath);
SDK تمام ساختارهای سطح‑پایین PDF را مدیریت میکند، بنابراین فایل ذخیرهشده محتواهای اصلی بهاضافه حاشیهنویسی جدید را حفظ میکند.
کد نمونه کامل: افزودن متن به PDF در .NET
مثال زیر کل فرآیند را از ابتدا تا انتها نشان میدهد.
using System;
using GroupDocs.Pdf;
using GroupDocs.Pdf.Contents;
using GroupDocs.Pdf.Contents.Text;
using GroupDocs.Pdf.Contents.Fonts;
class Program
{
static void Main()
{
string inputPath = "input.pdf";
string outputPath = "output.pdf";
// Load the existing PDF document
using (Document pdfDocument = new Document(inputPath))
{
// Ensure there is at least one page
Page page = pdfDocument.Pages.Count > 0 ? pdfDocument.Pages[0] : pdfDocument.Pages.Add();
// Create a text fragment to insert
TextFragment textFragment = new TextFragment("Added text using Conholdate.Total for .NET");
// Set visual properties
textFragment.Position = new Position(100, 150); // X and Y coordinates in points
textFragment.Font = new Font("Arial", 12);
textFragment.Color = new Color(255, 0, 0); // Red color
// Add the text fragment to the page
page.Paragraphs.Add(textFragment);
// Save the modified PDF
pdfDocument.Save(outputPath);
}
Console.WriteLine($"Text successfully added. Output saved to '{outputPath}'.");
}
}
توجه: این مثال کد عملکرد اصلی را نشان میدهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید که مسیرهای فایل و مقادیر پیکربندی را بهگونهای بهروزرسانی کنید که با محیط واقعی شما مطابقت داشته باشد، اطمینان حاصل کنید که تمام وابستگیهای مورد نیاز بهدرستی نصب شدهاند و بهطور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک با تیم پشتیبانی تماس بگیرید.
نتیجهگیری
افزودن متن به PDF در .NET بهراحتی با ویژگیهای قدرتمند Conholdate.Total for .NET امکانپذیر است. با دنبال کردن مراحل بالا میتوانید یک سند را بارگذاری کنید، یک TextFragment استایلدار ایجاد کنید، آن را بهدقت قرار دهید و نتیجه را تنها با چند خط کد ذخیره کنید. بهخاطر داشته باشید که برای استقرارهای تولیدی باید یک لایسنس معتبر اعمال کنید؛ میتوانید یک لایسنس موقت را از صفحه لایسنس دریافت کنید و گزینههای قیمتگذاری را در صفحه قیمتگذاری بررسی کنید. با این پایه، میتوانید رویکرد را به حاشیهنویسیهای چندخطی، درج دادههای پویا یا پردازش دستهای PDFها گسترش دهید.
سؤالات متداول
چگونه میتوانم متن را به PDF با استفاده از کتابخانه .NET وارد کنم؟
از کلاس TextFragment موجود در API PDF استفاده کنید، Position، Font و Color آن را تنظیم کنید، سپس آن را به مجموعه Paragraphs یک صفحه اضافه کنید. جریان کامل کار در مثال کد بالا نشان داده شده است.
آیا میتوانم متن را به PDF موجود با .NET بنویسم بدون اینکه محتوای دیگر بازنویسی شود؟
بله. SDK PDF را در محل خود تغییر میدهد و صفحات، تصاویر و حاشیهنویسیهای موجود را حفظ میکند در حالی که بخشهای متنی جدید را اضافه میکند.
بهترین روش برای افزودن متن به فایل PDF در .NET برای چندین صفحه چیست؟
در مجموعه Pages حلقه بزنید، برای هر صفحه یک TextFragment ایجاد کنید، موقعیت آن را پیکربندی کنید و به Paragraphs صفحه اضافه کنید. این رویکرد برای هر تعداد صفحهای مقیاسپذیر است.