كيفية إزالة تعليقات PDF وإنشاء صور مصغرة في .NET

في العديد من التطبيقات التي تركز على المستندات تحتاج إلى عرض معاينة نظيفة لملف PDF مع إخفاء أي تعليقات مضافة من قبل المستخدم. يُظهر لك هذا الدرس كيفية إزالة تعليقات PDF وإنشاء صور مصغرة لملف PDF في .NET، مع تقديم صور PNG واضحة تحتوي فقط على محتوى المستند الأصلي. بنهاية الدليل ستحصل على مقطع جاهز للإنتاج يعمل على .NET 5/6+، .NET Core، وإطار .NET الكلاسيكي.

إجابات سريعة

• ماذا يفعل RenderAnnotations = false؟ يخبر GroupDocs.Annotation بتخطي جميع التعليقات عند إنشاء المعاينة، بحيث يحتوي الناتج فقط على رسومات PDF الأصلية.
• أي تنسيق صورة يوفر أفضل جودة للصور المصغرة؟ يحافظ PNG على 100 % من بكسلات المصدر؛ يمكن لـ JPEG تقليل حجم الملف حتى 80 % لكنه يضيف عيوب ضغط.
• هل يمكنني اختيار صفحات محددة لمجموعة الصور المصغرة؟ نعم – قم بتعيين PreviewOptions.PageNumbers إلى أرقام الصفحات المطلوبة بالضبط.
• هل يلزم ترخيص للاستخدام في الإنتاج؟ الترخيص التجاري يفتح عدد غير محدود من الصفحات، يزيل علامة التقييم المائية، ويمنح دعمًا ذا أولوية.
• هل يعمل هذا مع .NET Core والإصدارات اللاحقة؟ بالطبع – يستهدف GroupDocs.Annotation .NET Framework، .NET Core، و .NET 5/6+.

ما هو إزالة تعليقات PDF؟

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

لماذا إنشاء معاينة بدون تعليقات؟

إنشاء معاينة تستثني التعليقات يمنح المستخدمين رؤية واضحة للمستند الأصلي، خالية من الملاحظات أو التمييز المشتت. هذه التمثيل النظيف يسرّع اتخاذ القرار، يحمي التعليقات السرية، ويضمن أن أي معالجة لاحقة (مثل الطباعة أو OCR) تعمل على المحتوى غير المعدل.

تحصل على تمثيل بصري نظيف يضمن:

• يسرّع دورات الموافقة – يرى المراجعون التخطيط الأصلي دون تشتيت، مما يقلل وقت المراجعة حتى 30 %.
• يحافظ على إخفاء الملاحظات الخاصة – تظل التعليقات مخزنة في PDF المصدر ولكنها لا تظهر أبدًا في معرض الصور المصغرة العام.
• يقلل استهلاك النطاق الترددي – صورة PNG مصغرة لصفحة واحدة عادةً ما تكون أقل من 200 KB، أصغر بكثير من إرسال ملف PDF كامل.
• يحسّن جودة الطباعة – عندما تُستخدم المعاينة لأصول جاهزة للطباعة، لن تتسبب التعليقات العشوائية في أخطاء طباعة غير متوقعة.

المتطلبات المسبقة

• GroupDocs.Annotation for .NET – قم بالتثبيت من صفحة الإصدارات الرسمية.
• الترخيص (اختياري لكن يُنصح به) – اشترِ ترخيصًا كاملاً عبر صفحة الشراء أو اطلب ترخيصًا مؤقتًا.
• معرفة أساسية بـ C#/.NET.
• عارض PDF (مثل Adobe Acrobat Reader) للتحقق من الصور المصغرة المُولدة.

استيراد مساحات الأسماء

أضف عبارات using المطلوبة لتتمكن من العمل مع واجهة برمجة تطبيقات التعليقات: توفر مساحة الأسماء Annotation الفئات الأساسية لتحميل ملفات PDF وتكوين خيارات المعاينة.

using GroupDocs.Annotation;
using GroupDocs.Annotation.Options;
using System.IO;

كيفية إنشاء صور مصغرة لملف PDF بدون تعليقات

حمّل ملف PDF المصدر، عطل عرض التعليقات، وصدر كل صفحة كصورة PNG. سير العمل بسيط: أنشئ كائن Annotator، اضبط PreviewOptions مع RenderAnnotations = false، حدّد الصفحات اختياريًا، واستدعِ GeneratePreview. هذا النهج ينتج صورًا مصغرة نظيفة في خطوة واحدة دون معالجة لاحقة إضافية.

الخطوة 1: تهيئة الـ Annotator

Annotator هو نقطة الدخول لجميع العمليات على ملف PDF. يفتح المستند، يدير الموارد، ويكشف عن وظائف المعاينة.

using (var annotator = new Annotator("sample.pdf"))
{

نصيحة احترافية: تحقق من مسار الملف وطبق فحوصات الأمان عند معالجة ملفات PDF التي يرفعها المستخدمون.

الخطوة 2: تكوين خيارات المعاينة

PreviewOptions يحدد كيفية إنشاء المعاينة. ضبط RenderAnnotations = false يعطل جميع طبقات التعليقات، بينما تتحكم خصائص OutputFormat و Dpi في جودة الصورة.

    var previewOptions = new PreviewOptions
    {
        OutputFormat = PreviewOutputFormat.Png,   // lossless PNG for crisp thumbnails
        Dpi = 150,                               // 150 DPI balances quality and size
        RenderAnnotations = false,               // core flag that removes annotations
        PageNumbers = new[] { 1, 2, 3 }           // generate thumbnails for the first three pages
    };

نقاط رئيسية

• تسمية الملفات – الدالة اللامبدا داخل GeneratePreview (الموضحة لاحقًا) تنشئ ملف PNG فريد لكل صفحة.
• اختيار التنسيق – PNG يحافظ على كل بكسل؛ انتقل إلى Jpeg إذا كنت بحاجة إلى حجم أصغر.
• اختيار الصفحات – حدد بالضبط الصفحات التي تريد إنشاء صور مصغرة لملف PDF لها، لتوفير دورات المعالج.

الخطوة 3: إنشاء المعاينة النظيفة

GeneratePreview ينشئ الصور بناءً على الخيارات التي حددتها ويكتبها إلى المجلد المستهدف.

    annotator.GeneratePreview(previewOptions, (pageNumber, stream) =>
    {
        var filePath = Path.Combine("thumbnails", $"page_{pageNumber}.png");
        using (var fileStream = File.Create(filePath))
        {
            stream.CopyTo(fileStream);
        }
    });
}

ملفات الصور المصغرة النظيفة (page_1.png، page_2.png، …) جاهزة الآن للاستخدام في أي مكوّن واجهة مستخدم.

حالات الاستخدام الشائعة في التطبيقات الفعلية

• أنظمة إدارة المستندات – عرض شبكة نظيفة من الصور المصغرة مع تخزين نسخة منفصلة مع تعليقات للمراجعين الداخليين.
• المنصات القانونية – تقديم العقد الأصلي للعملاء دون كشف ملاحظات المحاميين.
• بوابات التعلم الإلكتروني – عرض معاينات الواجبات بينما يبقي المعلمون تعليقات التقييم خاصة.
• سير عمل التسويق – إنشاء صور معاينة للكتيبات دون علامات المراجعة الداخلية.

اعتبارات الأداء

• المعالجة الدفعية – ضع عدة ملفات PDF في قائمة انتظار في عامل خلفية لتقليل عبء الإدخال/الإخراج.
• التخزين المؤقت – احفظ الصور المصغرة المُولدة في ذاكرة تخزين مؤقت مدعومة من CDN بعد التحميل الأول؛ الطلبات اللاحقة تصل إلى الذاكرة المؤقتة فورًا.
• حدود الصفحات – للملفات التي تتجاوز 500 صفحة، حدّ المعاينة إلى أول 5 صفحات للحفاظ على استهلاك المعالج أقل من 2 ثانية لكل مستند على خادم عادي بسرعة 2.5 GHz.
• مقايضات تنسيق الملفات – PNG يوفر جودة غير مضغوطة؛ JPEG يقلل التخزين حتى 80 % مع جودة بصرية مقبولة لمعارض الصور المصغرة.

استكشاف المشكلات الشائعة

• عدم إنشاء الصور المصغرة – تأكد من وجود مجلد الإخراج وأن عملية التطبيق لديها أذونات كتابة؛ كما تحقق من أن ملف PDF المصدر غير تالف.
• جودة صورة منخفضة – زد قيمة Dpi (مثلاً 300) أو انتقل إلى PNG إذا كنت تستخدم JPEG حاليًا.
• استخدام عالي للذاكرة – عالج الصفحات على دفعات أصغر أو فعّل وضع البث (annotator.Stream = true) لتجنب تحميل ملف PDF بالكامل في الذاكرة.
• مشكلات المسار – احرص دائمًا على بناء مسارات الملفات باستخدام Path.Combine() لضمان التوافق عبر الأنظمة.

أفضل الممارسات للإنتاج

• غلف عملية إنشاء المعاينة بكتلة try‑catch للتعامل مع أخطاء الإدخال/الإخراج وأخطاء الأذونات بشكل سلس.
• استخدم عبارات using (كما هو موضح) لضمان تحرير مقبض الملفات والموارد غير المُدارة بشكل صحيح.
• تحقق من صحة ملفات PDF الواردة (الحجم، التنسيق، الحماية بكلمة مرور) قبل المعالجة لمنع هجمات حجب الخدمة.
• سجّل كل حدث لإنشاء المعاينة (بما في ذلك عدد الصفحات والمدة) للمراقبة وتصحيح الأخطاء.

خيارات التكوين المتقدمة

• DPI مخصص – تسمح بعض إصدارات GroupDocs.Annotation بتعيين previewOptions.Dpi = 300 للحصول على صور مصغرة فائقة الوضوح.
• إضافة علامة مائية – أضف طبقة “معاينة فقط” عبر ربط كائن WatermarkOptions قبل استدعاء GeneratePreview.
• اختيار الصفحات الذكي – استخدم DocumentInfo لاكتشاف صفحة جدول المحتويات وإدراجها تلقائيًا في مجموعة الصور المصغرة.

الخلاصة

أصبح لديك الآن وصفة كاملة وجاهزة للإنتاج لإزالة تعليقات PDF وإنشاء صور مصغرة لملف PDF باستخدام GroupDocs.Annotation لـ .NET. من خلال ضبط RenderAnnotations = false، تُنشئ صور معاينة نظيفة مثالية للمعارض، سير عمل الموافقة، والمشاركة العامة—كل ذلك دون خطوات معالجة لاحقة إضافية.

الأسئلة المتكررة

س: هل يمكنني استخدام GroupDocs.Annotation لـ .NET مع صيغ غير PDF؟
A: نعم. المكتبة تدعم أيضًا DOCX، XLSX، PPTX، والعديد من صيغ الصور، وتطبق نفس سير عمل المعاينة بغض النظر عن نوع المصدر.

س: هل GroupDocs.Annotation لـ .NET متوافق مع .NET Core؟
A: بالتأكيد. يعمل على .NET Framework، .NET Core، و .NET 5/6+، لذا يمكنك استهداف تطبيقات عصرية متعددة المنصات.

س: هل توفر المكتبة أدوات تحرير التعليقات؟
A: نعم، لكنها عندما يكون RenderAnnotations = false يتم تجاهل تلك الأدوات أثناء إنشاء المعاينة، مما يضمن صورة نظيفة.

س: هل يمكنني دمج هذا في تطبيق ويب ASP.NET؟
A: نعم. فقط تأكد من أن خادم الويب لديه أذونات نظام ملفات مناسبة وفكّر في بث PNG مباشرة إلى العميل لتجنب الملفات المؤقتة.

س: أي تنسيق صورة يجب أن أختار لمعارض الصور المصغرة؟
A: PNG يوفر جودة غير مضغوطة، بينما JPEG يقلل حجم الملف حتى 80 %—اختر بناءً على جودة الصورة المطلوبة مقابل احتياجات النطاق الترددي.

س: أين يمكنني الحصول على دعم المجتمع؟
A: زر منتدى GroupDocs.Annotation GroupDocs.Annotation forum. المجتمع نشط ومتجاوب.

آخر تحديث: 2026-08-25
تم الاختبار مع: GroupDocs.Annotation for .NET 23.12
المؤلف: GroupDocs

using System.IO;
using GroupDocs.Annotation.Options;

using (Annotator annotator = new Annotator("annotated.pdf"))
{

    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = $"result{pageNumber}.png";
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] {1, 2, 3, 4, 5, 6};
    previewOptions.RenderAnnotations = false;

    annotator.Document.GeneratePreview(previewOptions);
}

الدروس ذات الصلة

• كيفية إنشاء صور مصغرة في .NET – معاينات PDF نظيفة
• إنشاء صورة مصغرة لملف PDF باستخدام GroupDocs.Annotation لـ .NET
• دروس إنشاء تعليقات PDF في .NET - دليل GroupDocs الكامل