Коли програма .NET працює у Windows, вона може використовувати збірку GroupDocs.Redaction для .NET, призначену для Windows. У цій інструкції показано, як створити консольну програму .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

Створіть консольну програму і виберіть цільову платформу .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 для .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 для .NET 26.10 працює в ознайомлювальному режимі. Один процес може відкрити до 25 документів. Спроба відкрити ще один документ спричиняє виняток TrialLimitationsException. У верхній частині кожної сторінки збережених документів додаються пробні позначки.

Тимчасова ліцензія доступна на сторінці тимчасових ліцензій GroupDocs. Постійна ліцензія доступна на сторінці придбання GroupDocs.

Докладніше