تنفيذ مسجل مخصص c# في GroupDocs.Redaction لـ .NET

إدارة عمليات إخفاء المستندات بكفاءة أمر حاسم، خاصة عند التعامل مع المعلومات الحساسة. في هذا الدليل ستتعلم كيفية تنفيذ مسجل مخصص c# مع GroupDocs.Redaction لـ .NET، مما يمنحك سيطرة كاملة على التسجيل، ومعالجة الأخطاء، وسلاسل التدقيق. بنهاية البرنامج التعليمي ستكون قادرًا على التقاط التحذيرات، الأخطاء، والرسائل المعلوماتية، دمج المسجل مع أطر تسجيل .NET الحالية، وحفظ المستند المُخفى دون تحويل إلى نقطية.

إجابات سريعة

  • ماذا يفعل مسجل مخصص c#؟ يقوم بالتقاط الأخطاء والتحذيرات والرسائل المعلوماتية أثناء الإخفاء، مما يمنحك سجل تدقيق قابل للبحث.
  • أي مكتبة توفر واجهة ILogger؟ توفر GroupDocs.Redaction لـ .NET واجهة ILogger.
  • هل يمكنني حفظ المستند المُخفى دون تحويل إلى نقطية؟ نعم – استدعِ redactor.Save(..., new Options.RasterizationOptions { Enabled = false }).
  • هل أحتاج إلى ترخيص للاستخدام في الإنتاج؟ يتطلب الترخيص الكامل للإنتاج؛ يتوفر ترخيص تجريبي للتقييم.
  • هل هذا النهج متوافق مع .NET Core / .NET 6+؟ بالطبع – نفس الـ API يعمل عبر .NET Framework و .NET Core و .NET 5 و .NET 6.

ما هو مسجل مخصص c#؟

إن مسجل مخصص c# هو فئة تُنفّذ واجهة ILogger التي توفرها GroupDocs.Redaction. يسمح لك بتوجيه رسائل السجل إلى أي مكان تحتاجه—الكونسول، الملف، قاعدة البيانات، أو أنظمة المراقبة الخارجية—مع توفير رؤية واضحة للمسار العام لعملية الإخفاء.

لماذا تستخدم تسجيل مخصص .net مع GroupDocs.Redaction؟

قم بتحميل عملية الإخفاء الخاصة بك بسجلات مفصلة وقابلة للبحث تلبي تدقيقات التنظيم وتسرّع من حل المشكلات. تدعم GroupDocs.Redaction أكثر من 70 تنسيقًا للإدخال والإخراج ويمكنها معالجة مستندات تصل إلى 500 صفحة دون تحميل الملف بالكامل في الذاكرة، لذا فإن مسجلًا مصممًا جيدًا يضيف حملاً ضئيلًا مع توفير رؤية لا تقدر بثمن.

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

  • GroupDocs.Redaction لـ .NET مثبت (انظر قسم Installation أدناه).
  • بيئة تطوير .NET (Visual Studio أو VS Code أو .NET CLI).
  • معرفة أساسية بـ C# وإلمام بتدفقات الملفات.

التثبيت

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
ابحث عن “GroupDocs.Redaction” وقم بتثبيت أحدث نسخة.

الحصول على الترخيص

  • Free trial: اختبار الـ API باستخدام ترخيص مؤقت.
  • Temporary license: احصل على وصول كامل للميزات لفترة محدودة.
  • Purchase: احصل على ترخيص دائم للنشر في بيئة الإنتاج.

دليل خطوة بخطوة

كيفية تنفيذ مسجل مخصص في .NET Core؟

حمّل فئة CustomLogger في مشروع .NET Core الخاص بك وربطها بـ RedactorSettings. يعمل المسجل بنفس الطريقة على .NET Framework و .NET 5 و .NET 6، لذا يمكنك مشاركة نفس الكود عبر جميع المنصات.

الخطوة 1: تعريف فئة مسجل مخصص (log warnings c#)

فئة CustomLogger تُنفّذ ILogger.
CustomLogger هي فئة معرفة من قبل المستخدم تُنفّذ واجهة ILogger لالتقاط أحداث الإخفاء.

using System;
using GroupDocs.Redaction;

class CustomLogger : ILogger
{
    public bool HasErrors { get; private set; }

    // Log errors encountered during processing.
    public void LogError(string message)
    {
        Console.WriteLine("Error: " + message);
        HasErrors = true;
    }

    // Log warnings that may not be critical but need attention.
    public void LogWarning(string message)
    {
        Console.WriteLine("Warning: " + message);
    }

    // Log informational messages for tracking normal operations.
    public void LogInfo(string message)
    {
        Console.WriteLine("Info: " + message);
    }
}

تعريف المرجع: CustomLogger هي تنفيذ معرف من قبل المستخدم لواجهة ILogger تسجل أحداث الإخفاء.
شرح: علامة HasErrors تساعدك على اتخاذ قرار ما إذا كنت ستستمر في المعالجة. الطرق الثلاثة تتطابق مع مستويات السجل الثلاث التي ستحتاجها في معظم سيناريوهات الإخفاء.

الخطوة 2: إعداد مسارات الملفات وفتح المستند المصدر

string sourceFile = Utils.PrepareOutputDirectory("YOUR_DOCUMENT_DIRECTORY");
string outputFile = Utils.GetOutputFile(sourceFile);

تعريف المرجع: Redactor هي الفئة الأساسية في GroupDocs.Redaction التي تقوم بعمليات الإخفاء على مستند PDF.
لماذا هذا مهم: استخدام طرق المساعدة يحافظ على نظافة الكود ويضمن وجود مجلد الإخراج قبل محاولة save redacted document.

الخطوة 3: تطبيق عمليات الإخفاء أثناء استخدام المسجل المخصص

using (Stream stream = File.Open(sourceFile, FileMode.Open, FileAccess.ReadWrite))
{
    var logger = new CustomLogger();
    
    using (Redactor redactor = new Redactor(stream, new LoadOptions(), new RedactorSettings(logger)))
    {
        // Apply a redaction to the document.
        redactor.Apply(new DeleteAnnotationRedaction());
        
        if (!logger.HasErrors)
        {
            using (Stream streamOut = File.Open(outputFile, FileMode.OpenOrCreate, FileAccess.ReadWrite))
            {
                // Save changes without rasterizing the output.
                redactor.Save(streamOut, new Options.RasterizationOptions { Enabled = false });
            }
        }
    }
}

الإجابة المباشرة: تبدأ سير عمل الإخفاء بإنشاء كائن Redactor باستخدام RedactorSettings(logger)، ثم تطبيق كائنات الإخفاء، والتحقق من logger.HasErrors، وأخيرًا استدعاء redactor.Save مع تعطيل التحويل إلى نقطية. يضمن هذا النمط تسجيل كل خطوة وأنك تحتفظ بمستند نظيف فقط عندما لا تحدث أخطاء.

شرح:

  1. يتم إنشاء Redactor باستخدام RedactorSettings(logger), مما يربط CustomLogger الخاص بك.
  2. بعد تطبيق عملية إخفاء، يتحقق الكود من logger.HasErrors. إذا لم تحدث أخطاء، يتم حفظ المستند—مما يوضح منطق save redacted document دون تحويل إلى نقطية.

المشكلات الشائعة & استكشاف الأخطاء

  • غياب مخرجات السجل: تحقق من أن كل طريقة Log* تم تجاوزها بشكل صحيح.
  • استثناءات الوصول إلى الملفات: تأكد من أن التطبيق يمتلك أذونات القراءة/الكتابة لكل من مسارات المصدر والإخراج.
  • المسجل غير موصول: معامل RedactorSettings(logger) أساسي؛ إهماله يعطل التسجيل المخصص.

التطبيقات العملية

  1. تقارير الامتثال: تصدير سجلات السجل إلى CSV أو قاعدة بيانات لسلاسل التدقيق.
  2. تتبع الأخطاء: تحديد الملفات المسببة للمشكلات بسرعة عبر فحص مخرجات LogError.
  3. أتمتة سير العمل: تشغيل عمليات لاحقة (مثل إبلاغ مسؤول الامتثال) عند استدعاء LogWarning.

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

  • إغلاق التدفقات فورًا لتحرير الذاكرة، خاصة عند معالجة دفعات كبيرة.
  • مراقبة CPU والذاكرة أثناء عمليات الإخفاء الضخمة؛ فكر في معالجة المستندات بالتوازي مع مزامنة المسجل بعناية.
  • ابق محدثًا: الإصدارات الأحدث من GroupDocs.Redaction غالبًا ما تتضمن تحسينات أداء وإضافات لسجلات إضافية.

الخلاصة

من خلال تنفيذ مسجل مخصص c#، تحصل على رؤية دقيقة لكل خطوة في خط أنابيب الإخفاء، مما يسهل الالتزام بمعايير الامتثال وتصحيح المشكلات. النهج المعروض هنا يعمل بسلاسة مع GroupDocs.Redaction لـ .NET ويمكن توسيعه للتكامل مع أي إطار تسجيل .NET تستخدمه بالفعل.

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

س: ما هو هدف التسجيل المخصص مع GroupDocs.Redaction؟
A: التسجيل المخصص يلتقط أحداث الإخفاء التفصيلية، يلبي متطلبات التدقيق، ويسهل استكشاف الأخطاء من خلال كشف الأخطاء والتحذيرات في الوقت الحقيقي.

س: كيف أتعامل مع الأخطاء باستخدام مسجل مخصص؟
A: نفّذ LogError في فئة CustomLogger الخاصة بك؛ علامة HasErrors تتيح لك إيقاف المعالجة إذا تم اكتشاف مشكلة حرجة.

س: هل يمكن دمج التسجيل المخصص مع أنظمة أخرى؟
A: نعم—يمكنك توجيه رسائل السجل إلى CRM أو ERP أو أدوات مراقبة مركزية عبر توسيع طرق المسجل.

س: ما هي المشكلات الشائعة عند تنفيذ التسجيل المخصص؟
A: غياب تجاوزات الطرق، نسيان تمرير RedactorSettings(logger)، وعدم كفاية أذونات الملفات هي أكثر المشكلات شيوعًا.

س: كيف يحسن التسجيل المخصص سير عمل إخفاء المستندات؟
A: السجلات التفصيلية توفر رؤية في الوقت الحقيقي، تُبسّط عملية تصحيح الأخطاء، وتولد سلاسل تدقيق مطلوبة من قبل اللوائح مثل GDPR و HIPAA.

الموارد

آخر تحديث: 2026-10-01
تم الاختبار مع: GroupDocs.Redaction 23.11 for .NET
المؤلف: GroupDocs

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