تحتاج العديد من التطبيقات إلى إضافة نص إلى PDF في .NET لتوضيح المستندات بشكل ديناميكي. Conholdate.Total for .NET هو مجموعة تطوير برامج شاملة تُبسّط التعامل مع ملفات PDF على الخادم أو سطح المكتب. في هذا الدليل ستتعرف على كيفية تثبيت المكتبة، تحميل ملف PDF موجود، إدراج نص منسق، وحفظ الملف المحدث مع مثال شفرة كامل وجاهز للتنفيذ.

متطلبات إضافة نص إلى PDF في Java

غالبًا ما يحتاج المطورون الذين يبنون واجهات أمامية مبنية على Java إلى خدمة .NET يمكنها تعديل ملفات PDF في الخلفية. تشمل المتطلبات النموذجية:

  • تحميل ملف PDF موجود دون فقدان المحتوى الحالي.
  • إضافة نص مخصص عند إحداثيات دقيقة، مع خط ولون محددين.
  • حفظ ملف PDF المعدل مع الحفاظ على التخطيط والبيانات الوصفية الأصلية.

لا يمكن للتحرير اليدوي أو أدوات سطر الأوامر العامة تلبية هذه الاحتياجات في سير عمل آلي، خاصةً عندما يجب تنفيذ العملية برمجيًا للعديد من الملفات.

اختيار Conholdate.Total for .NET للوظيفة

Conholdate.Total for .NET يقدم مجموعة غنية من واجهات برمجة تطبيقات PDF التي تلبي المتطلبات المذكورة أعلاه مباشرة. يمكنه:

  • افتح وقم بتحرير ملفات PDF دون تحويل.
  • أنشئ كائنات TextFragment مع تحكم كامل في التنسيق.
  • أدخل المقاطع في أي صفحة في المواقع الدقيقة.
  • احفظ النتيجة باستدعاء طريقة واحدة.

يتم تسليم SDK كحزمة NuGet، ويعمل على جميع أطر تشغيل .NET، ويتضمن وثائق مفصلة التوثيق ومرجع API شامل مرجع API. يمكنك تنزيل أحدث نسخة من صفحة الإصدار.

دليل خطوة‑بخطوة: إضافة نص إلى PDF في .NET

فيما يلي شرح عملي يعكس الشيفرة المعروضة لاحقًا في المثال الكامل.

Install Conholdate.Total for .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 هي جزء من واجهة برمجة تطبيقات 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 من واجهة برمجة تطبيقات PDF، واضبط خصائص Position و Font و Color، ثم أضفها إلى مجموعة Paragraphs للصفحة. يتم توضيح سير العمل الكامل في مثال الشيفرة أعلاه.

هل يمكنني كتابة نص إلى ملف PDF موجود باستخدام .NET دون استبدال المحتوى الآخر؟

نعم. يقوم SDK بتعديل ملف PDF في مكانه، مع الحفاظ على الصفحات والصور والتعليقات التوضيحية الموجودة أثناء إضافة مقاطع نصية جديدة.

ما هي أفضل طريقة لإضافة نص إلى ملف PDF في .NET لعدة صفحات؟

قم بالتكرار عبر مجموعة Pages، أنشئ TextFragment لكل صفحة، اضبط موقعه، وأضفه إلى Paragraphs الخاصة بالصفحة. هذا النهج يتوسع لأي عدد من الصفحات.

اقرأ المزيد