Saat aplikasi .NET berjalan di Windows, aplikasi tersebut dapat menggunakan build khusus Windows dari GroupDocs.Redaction untuk .NET. Tutorial ini menunjukkan cara membuat aplikasi konsol .NET 10 yang menargetkan net10.0-windows, menyensor frasa dalam dokumen Word menggunakan ekspresi reguler, dan menyimpan dokumen yang telah disensor.

Versi proyek yang lengkap dan dapat dijalankan tersedia di GitHub.

1. Buat proyek konsol .NET untuk Windows

Anda dapat membuat proyek menggunakan Visual Studio atau .NET CLI. Proyek harus menargetkan net10.0-windows. NuGet memulihkan assembly khusus Windows GroupDocs.Redaction.Net100.Windows untuk kerangka kerja target ini. Build ini menyertakan dependensi khusus Windows.

Proyek yang menargetkan net10.0 tanpa akhiran -windows menggunakan build lintas platform.

Menggunakan Visual Studio

Buat Aplikasi Konsol baru dan pilih .NET 10.0 sebagai kerangka kerja target. Setelah proyek dibuat, buka file proyek dan atur kerangka kerja target:

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

Menggunakan .NET CLI

Buat aplikasi konsol .NET 10 dan buka direktori proyek:

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

Kemudian atur kerangka kerja target yang sama di WindowsSpecificRedaction.csproj:

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

File proyek pada langkah ini adalah:

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

2. Instal GroupDocs.Redaction 26.10

Tambahkan GroupDocs.Redaction untuk .NET 26.10.0 menggunakan Visual Studio atau .NET CLI.

Menggunakan Visual Studio

  1. Klik kanan proyek di Solution Explorer.
  2. Pilih Manage NuGet Packages.
  3. Cari GroupDocs.Redaction dan instal versi 26.10.0.

Menggunakan .NET CLI

Jalankan perintah ini dari direktori proyek:

dotnet add package GroupDocs.Redaction --version 26.10.0

Paket ini menyediakan kelas Redactor untuk memuat dan menyimpan dokumen, RegexRedaction untuk menyensor kecocokan ekspresi reguler, dan properti License.IsLicensed untuk memeriksa apakah lisensi yang valid diterapkan.

3. Tambahkan file Word

Letakkan dokumen Word di direktori proyek dan beri nama:

document.docx

Di file proyek, konfigurasikan dokumen agar disalin ke direktori keluaran build:

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

Dokumen contoh berisi frasa essential tool. Aplikasi mengganti frasa yang cocok dan membuat document_Redacted.docx. File asli document.docx tetap tidak berubah.

4. Tambahkan kode sensor

Buka Program.cs dan ganti isinya dengan kode berikut:

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

Properti License.IsLicensed mengembalikan false sampai SetLicense memuat lisensi yang valid. Untuk menjalankan aplikasi dalam mode berlisensi, hapus komentar pada panggilan SetLicense dan berikan jalur ke file lisensi Anda.

Ekspresi reguler \s+essential tool cocok dengan satu atau beberapa karakter spasi putih yang diikuti frasa essential tool. Pencarian tidak membedakan huruf besar dan kecil, sehingga Essential Tool juga cocok. Setiap kecocokan, termasuk spasi sebelum frasa, diganti dengan [redacted].

Properti RasterizeToPDF diatur ke false, sehingga dokumen tetap dalam format Word. Properti AddSuffix diatur ke true, sehingga file keluaran disimpan dengan akhiran Redacted:

document_Redacted.docx

Metode Save mengembalikan jalur ke file yang disimpan.

5. Jalankan aplikasi

Menggunakan Visual Studio

  1. Buka WindowsSpecificRedaction.slnx, atau buka file proyek.
  2. Tekan F5 untuk men-debug atau Ctrl+F5 untuk menjalankan tanpa debugging.

Saat aplikasi dijalankan dari Visual Studio, direktori kerja biasanya adalah direktori keluaran build. File yang telah disensor disimpan di:

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

Menggunakan .NET CLI

Jalankan perintah berikut dari direktori proyek:

dotnet run

Saat menggunakan dotnet run, direktori kerja adalah direktori proyek. Aplikasi membaca document.docx dari direktori ini dan menyimpan document_Redacted.docx di sampingnya.

6. Periksa dokumen yang telah disensor

Buka document_Redacted.docx. Frasa essential tool seharusnya diganti dengan [redacted]. File asli document.docx tetap tidak berubah.

Anda dapat menggunakan proyek yang sama untuk menyensor frasa lain dengan mengubah ekspresi reguler dan teks pengganti.

Lisensi

Tanpa lisensi, GroupDocs.Redaction untuk .NET 26.10 berjalan dalam mode evaluasi. Satu proses dapat membuka hingga 25 dokumen. Upaya membuka dokumen lain akan memunculkan TrialLimitationsException. Lencana uji coba ditambahkan di bagian atas setiap halaman pada dokumen yang disimpan.

Lisensi sementara tersedia di halaman lisensi sementara GroupDocs. Lisensi permanen tersedia di halaman pembelian GroupDocs.

Pelajari selengkapnya