هنگامی که یک برنامه .NET بر روی ویندوز اجرا می‌شود، می‌تواند از نسخه مخصوص ویندوز GroupDocs.Redaction for .NET استفاده کند. این آموزش نشان می‌دهد چگونه یک برنامه کنسولی .NET 10 ایجاد کنید که هدف‌گیری net10.0-windows داشته باشد، یک عبارت در یک سند Word را با استفاده از عبارت منظم مخفی کنید و سند مخفی‌شده را ذخیره کنید.

یک نسخه کامل و قابل اجرا از پروژه در GitHub موجود است.

1. ایجاد یک پروژه کنسولی .NET برای ویندوز

می‌توانید پروژه را با Visual Studio یا .NET CLI ایجاد کنید. پروژه باید هدف‌گیری net10.0-windows را داشته باشد. NuGet اسمبلی مخصوص ویندوز GroupDocs.Redaction.Net100.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 تا زمانی که SetLicense یک لایسنس معتبر بارگذاری نکند، مقدار false برمی‌گرداند. برای اجرای برنامه در حالت لایسنس‌دار، فراخوانی 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 در حالت ارزیابی اجرا می‌شود. یک فرآیند می‌تواند حداکثر ۲۵ سند را باز کند. تلاش برای باز کردن سند دیگر منجر به پرتاب TrialLimitationsException می‌شود. نشان‌های آزمایشی به بالای هر صفحه در اسناد ذخیره‌شده اضافه می‌شوند.

یک لایسنس موقت در صفحه لایسنس موقت GroupDocs موجود است. یک لایسنس دائمی در صفحه خرید GroupDocs قابل دسترس است.

بیشتر بدانید