عند تشغيل تطبيق .NET على نظام Windows، يمكنه استخدام نسخة Windows‑specific من GroupDocs.Redaction for .NET. يوضح هذا الدليل كيفية إنشاء تطبيق وحدة تحكم .NET 10 يستهدف net10.0-windows، وحذف عبارة في مستند Word باستخدام تعبير نمطي، وحفظ المستند المحذوف.

نسخة كاملة تعمل من المشروع متوفرة على GitHub.

1. إنشاء مشروع وحدة تحكم .NET لنظام Windows

يمكنك إنشاء المشروع باستخدام Visual Studio أو سطر أوامر .NET CLI. يجب أن يستهدف المشروع net10.0-windows. يقوم NuGet باستعادة التجميع GroupDocs.Redaction.Net100.Windows الخاص بنظام Windows لهذا الإطار المستهدف. يتضمن هذا البناء تبعيات خاصة بنظام Windows.

المشاريع التي تستهدف net10.0 بدون لاحقة -windows تستخدم البناء المتعدد المنصات.

باستخدام Visual Studio

أنشئ تطبيق Console جديد واختر .NET 10.0 كإطار مستهدف. بعد إنشاء المشروع، افتح ملف المشروع واضبط إطار الهدف:

<TargetFramework>net10.0-windows</TargetFramework>

باستخدام .NET CLI

أنشئ تطبيق وحدة تحكم .NET 10 وافتح دليل المشروع:

dotnet new console -n WindowsSpecificRedaction -f net10.0
cd WindowsSpecificRedaction

ثم اضبط نفس إطار الهدف في WindowsSpecificRedaction.csproj:

<TargetFramework>net10.0-windows</TargetFramework>

ملفات المشروع في هذه الخطوة هي:

WindowsSpecificRedaction/
├── WindowsSpecificRedaction.csproj
└── Program.cs

2. تثبيت GroupDocs.Redaction 26.10

أضف GroupDocs.Redaction for .NET 26.10.0 باستخدام Visual Studio أو .NET CLI.

باستخدام Visual Studio

  1. انقر بزر الماوس الأيمن على المشروع في Solution Explorer.
  2. اختر Manage NuGet Packages.
  3. ابحث عن GroupDocs.Redaction وقم بتثبيت الإصدار 26.10.0.

باستخدام .NET CLI

نفّذ هذا الأمر من دليل المشروع:

dotnet add package GroupDocs.Redaction --version 26.10.0

توفر الحزمة الفئة Redactor لتحميل وحفظ المستندات، وRegexRedaction لحذف التطابقات التي تمثل تعبيرًا نمطيًا، وخصائص License.IsLicensed للتحقق مما إذا تم تطبيق ترخيص صالح.

3. إضافة ملف Word

ضع مستند Word في دليل المشروع وسمّه:

document.docx

في ملف المشروع، قم بتهيئة المستند ليُنسخ إلى دليل إخراج البناء:

<ItemGroup>
  <None Update="document.docx">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </None>
</ItemGroup>

المستند النموذجي يحتوي على العبارة essential tool. يقوم التطبيق باستبدال العبارة المطابقة وينشئ document_Redacted.docx. يبقى الملف الأصلي document.docx دون تغيير.

4. إضافة كود الحذف

افتح Program.cs واستبدل محتوياته بالكود التالي:

using GroupDocs.Redaction;
using GroupDocs.Redaction.Options;
using GroupDocs.Redaction.Redactions;
using System.Text.RegularExpressions;

var license = new License();
// license.SetLicense("your_license_path");

if (!license.IsLicensed)
{
    Console.WriteLine("The library is running in evaluation mode. Some limitations may apply.");
}

using (Redactor redactor = new Redactor("document.docx"))
{
    var regex = new Regex(@"\s+essential tool", RegexOptions.IgnoreCase);
    redactor.Apply(new RegexRedaction(regex, new ReplacementOptions(" [redacted]")));

    var saveOptions = new SaveOptions() { AddSuffix = true, RasterizeToPDF = false };
    var outputFile = redactor.Save(saveOptions);

    Console.WriteLine($"File saved to {outputFile}.");
}

خاصية License.IsLicensed تُعيد false حتى يتم تحميل ترخيص صالح عبر SetLicense. ألغِ التعليق عن استدعاء SetLicense ووفّر مسار ملف الترخيص لتشغيل التطبيق في وضع مرخص.

التعبير النمطي \s+essential tool يطابق حرفًا أو أكثر من مسافات بيضاء يليه العبارة essential tool. البحث غير حساس لحالة الأحرف، لذا يطابق أيضًا Essential Tool. كل تطابق، بما في ذلك المسافة قبل العبارة، يُستبدل بـ [redacted].

تم ضبط خاصية RasterizeToPDF على false، لذا يبقى المستند بصيغته Word. تم ضبط خاصية AddSuffix على true، لذا يُحفظ الملف الناتج بلاحقة Redacted:

document_Redacted.docx

طريقة Save تُعيد مسار الملف المحفوظ.

5. تشغيل التطبيق

باستخدام Visual Studio

  1. افتح WindowsSpecificRedaction.slnx أو ملف المشروع.
  2. اضغط F5 للتصحيح أو Ctrl+F5 للتشغيل دون تصحيح.

عند تشغيل التطبيق من Visual Studio، يكون دليل العمل عادةً دليل إخراج البناء. يُحفظ الملف المحذوف في:

bin\Debug\net10.0-windows\document_Redacted.docx

باستخدام .NET CLI

نفّذ الأمر التالي من دليل المشروع:

dotnet run

عند استخدام dotnet run، يكون دليل العمل هو دليل المشروع. يقرأ التطبيق document.docx من هذا الدليل ويحفظ document_Redacted.docx بجانبه.

6. فحص المستند المحذوف

افتح document_Redacted.docx. يجب أن تُستبدل العبارة essential tool بـ [redacted]. يبقى الملف الأصلي document.docx دون تغيير.

يمكنك استخدام نفس المشروع لحذف عبارات أخرى بتعديل التعبير النمطي ونص الاستبدال.

الترخيص

بدون ترخيص، يعمل GroupDocs.Redaction for .NET 26.10 في وضع التقييم. يمكن لعملية واحدة فتح ما يصل إلى 25 مستندًا. محاولة فتح مستند آخر تُسبب استثناء TrialLimitationsException. تُضاف شارات تجريبية إلى أعلى كل صفحة في المستندات المحفوظة.

ترخيص مؤقت متاح على صفحة الترخيص المؤقت لـ GroupDocs. ترخيص دائم متاح على صفحة شراء GroupDocs.

معرفة المزيد