Khi một ứng dụng .NET chạy trên Windows, nó có thể sử dụng bản dựng dành riêng cho Windows của GroupDocs.Redaction for .NET. Hướng dẫn này chỉ cách tạo một ứng dụng console .NET 10 nhắm tới net10.0-windows, xóa một cụm từ trong tài liệu Word bằng biểu thức chính quy, và lưu tài liệu đã xóa.

Một phiên bản hoàn chỉnh, có thể chạy được của dự án có trên GitHub.

1. Tạo dự án .NET Console cho Windows

Bạn có thể tạo dự án bằng Visual Studio hoặc .NET CLI. Dự án phải nhắm tới net10.0-windows. NuGet sẽ khôi phục assembly GroupDocs.Redaction.Net100.Windows dành riêng cho Windows cho khung mục tiêu này. Bản dựng này bao gồm các phụ thuộc đặc thù của Windows.

Các dự án nhắm tới net10.0 mà không có hậu tố -windows sẽ sử dụng bản dựng đa nền tảng.

Sử dụng Visual Studio

Tạo một Console App mới và chọn .NET 10.0 làm khung mục tiêu. Sau khi tạo dự án, mở file dự án và đặt khung mục tiêu:

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

Sử dụng .NET CLI

Tạo một ứng dụng console .NET 10 và mở thư mục dự án:

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

Sau đó đặt cùng một khung mục tiêu trong WindowsSpecificRedaction.csproj:

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

Các file dự án ở bước này là:

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

2. Cài đặt GroupDocs.Redaction 26.10

Thêm GroupDocs.Redaction for .NET 26.10.0 bằng Visual Studio hoặc .NET CLI.

Sử dụng Visual Studio

  1. Nhấp chuột phải vào dự án trong Solution Explorer.
  2. Chọn Manage NuGet Packages.
  3. Tìm GroupDocs.Redaction và cài đặt phiên bản 26.10.0.

Sử dụng .NET CLI

Chạy lệnh sau từ thư mục dự án:

dotnet add package GroupDocs.Redaction --version 26.10.0

Gói này cung cấp lớp Redactor để tải và lưu tài liệu, RegexRedaction để xóa các khớp biểu thức chính quy, và thuộc tính License.IsLicensed để kiểm tra xem giấy phép hợp lệ đã được áp dụng chưa.

3. Thêm tệp Word

Đặt tài liệu Word vào thư mục dự án và đặt tên:

document.docx

Trong file dự án, cấu hình tài liệu để sao chép vào thư mục đầu ra của bản dựng:

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

Tài liệu mẫu chứa cụm từ essential tool. Ứng dụng sẽ thay thế cụm từ này và tạo ra document_Redacted.docx. Tệp gốc document.docx vẫn không bị thay đổi.

4. Thêm mã xóa

Mở Program.cs và thay thế nội dung bằng đoạn mã sau:

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}.");
}

Thuộc tính License.IsLicensed trả về false cho đến khi SetLicense tải một giấy phép hợp lệ. Bỏ chú thích dòng SetLicense và cung cấp đường dẫn tới tệp giấy phép của bạn để chạy ứng dụng ở chế độ có giấy phép.

Biểu thức chính quy \s+essential tool khớp một hoặc nhiều ký tự khoảng trắng tiếp theo là cụm từ essential tool. Tìm kiếm không phân biệt chữ hoa/thường, vì vậy Essential Tool cũng sẽ khớp. Mỗi khớp, bao gồm cả khoảng trắng trước cụm từ, sẽ được thay thế bằng [redacted].

Thuộc tính RasterizeToPDF được đặt thành false, vì vậy tài liệu vẫn giữ định dạng Word. Thuộc tính AddSuffix được đặt thành true, nên tệp đầu ra sẽ được lưu với hậu tố Redacted:

document_Redacted.docx

Phương thức Save trả về đường dẫn tới tệp đã lưu.

5. Chạy ứng dụng

Sử dụng Visual Studio

  1. Mở WindowsSpecificRedaction.slnx, hoặc mở file dự án.
  2. Nhấn F5 để debug hoặc Ctrl+F5 để chạy mà không debug.

Khi chạy ứng dụng từ Visual Studio, thư mục làm việc thường là thư mục đầu ra của bản dựng. Tệp đã xóa sẽ được lưu vào:

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

Sử dụng .NET CLI

Chạy lệnh sau từ thư mục dự án:

dotnet run

Khi dùng dotnet run, thư mục làm việc là thư mục dự án. Ứng dụng sẽ đọc document.docx từ thư mục này và lưu document_Redacted.docx cùng vị trí.

6. Kiểm tra tài liệu đã xóa

Mở document_Redacted.docx. Cụm từ essential tool sẽ được thay thế bằng [redacted]. Tệp gốc document.docx vẫn không thay đổi.

Bạn có thể dùng cùng dự án này để xóa các cụm từ khác bằng cách chỉnh sửa biểu thức chính quy và văn bản thay thế.

Giấy phép

Nếu không có giấy phép, GroupDocs.Redaction for .NET 26.10 chạy ở chế độ đánh giá. Một tiến trình duy nhất có thể mở tối đa 25 tài liệu. Cố gắng mở tài liệu khác sẽ ném ra ngoại lệ TrialLimitationsException. Các biểu tượng đánh dấu thử nghiệm sẽ được thêm vào đầu mỗi trang trong tài liệu đã lưu.

Một giấy phép tạm thời có sẵn trên trang giấy phép tạm thời của GroupDocs. Giấy phép vĩnh viễn có sẵn trên trang mua GroupDocs.

Tìm hiểu thêm