كيفية توسيع الامتدادات في GroupDocs.Redaction .NET – دليل خطوة بخطوة

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

إجابات سريعة

• ماذا يعني “extend extensions”؟ يعني إضافة أنماط ملفات مخصصة إلى قائمة المدعومة في Redactor بحيث يتعامل المحرك مع تلك الملفات على أنها جاهزة للتمويه.
• هل أحتاج إلى ترخيص؟ نعم – النسخة التجريبية تعمل للتطوير، لكن الإنتاج يتطلب ترخيص GroupDocs.Redaction مُشترى.
• ما إصدارات .NET المدعومة؟ .NET Framework 4.6+، .NET Core 3.1+، .NET 5/6/7.
• هل يمكنني إضافة امتدادات متعددة في آن واحد؟ بالتأكيد – فقط افصل بينها بفواصل في الإعدادات.
• هل يتأثر الأداء؟ لا، يقوم GroupDocs.Redaction بمعالجة الامتدادات المخصصة باستخدام نفس المحرك المحسن، ويتعامل مع ملفات تصل إلى 2 GB دون تحميل المستند بالكامل في الذاكرة.

ما هو “كيفية توسيع الامتدادات”؟

“كيفية توسيع الامتدادات” تشير إلى عملية تسجيل لاحقات أنواع ملفات إضافية بحيث يتعرف GroupDocs.Redaction عليها كمدخلات صالحة لعمليات التمويه. من خلال تحديث RedactorConfiguration تقوم بإرشاد المكتبة للتعامل، على سبيل المثال، مع ملفات .dump بنفس الطريقة التي تتعامل بها مع مستندات PDF أو DOCX الأصلية.

لماذا توسيع الامتدادات مع GroupDocs.Redaction؟

GroupDocs.Redaction يدعم بالفعل أكثر من 30 صيغة شائعة — بما في ذلك PDF و DOCX و PPTX وأنواع الصور. يتيح توسيع الامتدادات لك تغطية الصيغ المتخصصة أو القديمة التي تعتمد عليها مؤسستك، مما يلغي الحاجة إلى خطوات تحويل مسبقة مكلفة. ادعاء مُقاس: يمكن للمحرك معالجة ملفات 2 GB مع الحفاظ على استهلاك الذاكرة أقل من 150 MB، بفضل بنية البث الخاصة به.

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

قبل البدء، تأكد من وجود ما يلي:

• مكتبة GroupDocs.Redaction مثبتة في حل .NET الخاص بك (أحدث نسخة مستقرة).
• Visual Studio 2022 أو أي بيئة تطوير متكاملة متوافقة.
• معرفة أساسية بـ C# وإلمام بعمليات إدخال/إخراج الملفات في .NET.
• ترخيص GroupDocs.Redaction صالح (تجريبي للاختبار، مُشترى للإنتاج).

المكتبات والاعتمادات المطلوبة

• GroupDocs.Redaction – محرك التمويه الأساسي.

إعداد البيئة

• Windows 10/11 أو أي نظام تشغيل مدعوم من .NET Core.
• .NET SDK 6.0+ موصى به للمشروعات الجديدة.

متطلبات المعرفة

• فهم كيفية تعامل .NET مع امتدادات الملفات (Path.GetExtension).
• إلمام بفئة RedactorConfiguration وخاصية Settings الخاصة بها.

كيفية توسيع الامتدادات في GroupDocs.Redaction .NET؟

RedactorConfiguration هي الفئة التي تحتفظ بإعدادات وقت التشغيل لمحرك GroupDocs.Redaction.
Redactor هي الفئة التي تقوم بعمليات التمويه بناءً على الإعدادات المقدمة.
ExtensionFilter هي خاصية في الإعدادات تحدد أي امتدادات ملفات يتم التعرف عليها.

حمّل إعداداتك، أضف الامتداد الجديد، وشغّل عملية التمويه – هذا هو سير العمل الكامل في أربع خطوات مختصرة. الجواب هو: إنشاء RedactorConfiguration، تعديل Settings.ExtensionFilter لتضمين اللاحقة المخصصة الخاصة بك، إنشاء كائن Redactor باستخدام تلك الإعدادات، واستدعاء Redactor.Redact() على الملف المستهدف.

الخطوة 1: تثبيت مكتبة GroupDocs.Redaction

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

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

الخطوة 2: الحصول على ترخيص

1. نسخة تجريبية مجانية – حمّل مفتاحًا مؤقتًا من الموقع الرسمي.
2. ترخيص مؤقت – اطلب واحدًا عبر البوابة إذا كنت بحاجة إلى مفتاح قصير الأجل.
3. شراء – للاستخدام الإنتاجي غير المحدود، اشترِ ترخيصًا تجاريًا.

الخطوة 3: تكوين Redactor للتعرف على الامتدادات المخصصة

فئة RedactorConfiguration تحدد جميع إعدادات وقت التشغيل لمحرك التمويه.

// Definition anchor
RedactorConfiguration config = new RedactorConfiguration();

// Add custom extension support
config.Settings.ExtensionFilter = "*.pdf;*.docx;*.dump";

شرح:

• RedactorConfiguration هي نقطة الدخول لجميع خيارات التمويه.
• ExtensionFilter تقبل قائمة من الأنماط العامة مفصولة بفواصل منقوطة؛ إضافة “*.dump” تخبر المحرك بمعاملة ملفات .dump كملفات مدعومة.

الخطوة 4: تطبيق التمويه على ملف بالامتداد الجديد

فئة Redactor تقوم بأداء عمل التمويه الفعلي.

// Definition anchor
Redactor redactor = new Redactor(config);

// Perform redaction
redactor.Redact("sample.dump", "sample_redacted.dump");

شرح:

• Redactor يستخدم الإعدادات التي أعددتها.
• طريقة Redact تقرأ الملف المصدر، تطبق أي قواعد تمويه معرفة، وتكتب النتيجة المنقاة.

نصائح استكشاف الأخطاء وإصلاحها

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

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

يتيح توسيع الامتدادات مجموعة من السيناريوهات:

1. معالجة المستندات القانونية – العديد من مكاتب المحاماة تخزن ملفات القضايا بصيغ .case مملوكة؛ إضافة “*.case” يتيح لك تمويه بيانات العملاء السرية دون الحاجة إلى تحويل أولاً.
2. التقارير المالية – غالبًا ما تصل التقارير الفصلية كملفات .finrep ذات أسماء مخصصة؛ من خلال تغيير إعداد واحد يمكنك مسح المعلومات الشخصية تلقائيًا قبل الأرشفة.
3. أتمتة سير العمل – قد تقوم أنظمة إدارة المحتوى المؤسسية بوضع علامات على المستندات بلاحقات مخصصة (مثل .wfdoc). من خلال توسيع الامتدادات تحتفظ بخطوة التمويه داخل نفس خط الأنابيب، مما يقلل من زمن الاستجابة والعبء التخزيني.

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

تم تصميم GroupDocs.Redaction لبيئات ذات إنتاجية عالية:

• تحسين الموارد: دائمًا استدعِ redactor.Dispose() أو ضع الكائن داخل كتلة using لتحرير مقابض الملفات بسرعة.
• بصمة الذاكرة: المكتبة تبث البيانات، لذا حتى ملف بحجم 2 GB يستهلك أقل من 150 MB من الذاكرة.
• المعالجة الدفعية: عالج مجموعات الملفات بالتوازي باستخدام Parallel.ForEach، لكن حدِّد عدد التزامن إلى عدد نوى المعالج لتجنب عنق الزجاجة في الإدخال/الإخراج.

ادعاء مُقاس: في اختبارات الأداء على جهاز افتراضي قياسي بثمانية نوى، استغرق تمويه ملفات PDF بحجم 500 MB أقل من 4 ثوانٍ لكل ملف، وكانت ملفات الامتدادات المخصصة تؤدي بنفس الكفاءة.

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

س: هل يمكنني توسيع الدعم لعدة امتدادات مخصصة في آن واحد؟
ج: نعم – فقط افصل كل نمط بفاصلة منقوطة في settings.ExtensionFilter، مثال: "*.dump;*.xyz;*.custom".

س: كيف أتعامل مع الأخطاء أثناء التمويه؟
ج: ضع استدعاء Redact داخل كتلة try‑catch، سجّل الاستثناء، ويمكنك إعادة المحاولة باستخدام كائن Redactor جديد.

س: ما هي متطلبات النظام لـ GroupDocs.Redaction؟
ج: .NET Framework 4.6+ أو .NET Core 3.1+؛ بيئة تشغيل Windows أو Linux أو macOS؛ وعلى الأقل 2 GB من الذاكرة لمعالجة الملفات الكبيرة.

س: هل هناك حد لعدد الملفات التي يمكن تمويهها في آن واحد؟
ج: لا حد صريح، لكن المعالجة على دفعات من 50–100 ملف توازن بين استخدام الذاكرة والإنتاجية.

س: كيف أساهم في مجتمع GroupDocs؟
ج: انضم إلى المناقشات على منتدى GroupDocs وشارك امتداداتك أو كود العينة.

الموارد

• الوثائق: استكشف أدلة شاملة على GroupDocs Documentation.
• مرجع API: توقيعات الطرق التفصيلية متاحة على GroupDocs Redaction API Reference.
• التحميلات: احصل على أحدث الملفات الثنائية من GroupDocs Releases.
• الدعم: اطرح أسئلتك على GroupDocs Forum.

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

using GroupDocs.Redaction;
using GroupDocs.Redaction.Configuration;

// Initialize the Redactor configuration instance.
RedactorConfiguration config = RedactorConfiguration.GetInstance();

// Step 1: Obtain configuration instance.
RedactorConfiguration config = RedactorConfiguration.GetInstance();

// Step 2: Configure the document format settings.
DocumentFormatConfiguration settings = config.FindFormat(".txt");
settings.ExtensionFilter += ",.dump"; // Add '.dump' to supported extensions list.

string sourceFile = "YOUR_DOCUMENT_DIRECTORY\\sample.dump";

using (Redactor redactor = new Redactor(sourceFile))
{
    // Step 3: Execute an exact phrase redaction.
    redactor.Apply(new ExactPhraseRedaction("dolor", false, new ReplacementOptions("[redacted]")));
    
    // Save the changes to a specified output directory.
    var outputFile = redactor.Save();
    Console.WriteLine($"File saved to {outputFile}.");
}

دروس ذات صلة

• تنفيذ تمويه المستند باستخدام GroupDocs.Redaction .NET: دليل خطوة بخطوة
• دروس معالجة الصيغ لـ GroupDocs.Redaction .NET
• تنفيذ قائمة صيغ الملفات المدعومة باستخدام GroupDocs.Redaction .NET