เมื่อแอปพลิเคชัน .NET ทำงานบน Windows แอปพลิเคชันสามารถใช้บิลด์เฉพาะ Windows ของ 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

สร้างแอปคอนโซลใหม่และเลือก .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

เรียนรู้เพิ่มเติม