วิธีขยายส่วนขยายใน GroupDocs.Redaction .NET – คู่มือขั้นตอนต่อขั้นตอน

ในองค์กรสมัยใหม่ การปกป้องข้อมูลที่ละเอียดอ่อนในรูปแบบเอกสารที่หลากหลายเป็นข้อกำหนดที่ไม่อาจต่อรองได้ ดังนั้น how to extend extensions ใน GroupDocs.Redaction สำหรับ .NET จึงมีความสำคัญ: มันทำให้คุณสามารถเพิ่มการสนับสนุนไฟล์ที่เป็นกรรมสิทธิ์หรือใช้ไม่บ่อยโดยไม่กระทบต่อความปลอดภัยหรือประสิทธิภาพ ในบทเรียนนี้คุณจะได้เรียนรู้ขั้นตอนที่แน่นอน ดูกรณีการใช้งานจริง และรับเคล็ดลับเชิงปฏิบัติเพื่อให้สายงานการทำลบข้อมูลของคุณเร็วและเชื่อถือได้

คำตอบด่วน

  • What does “extend extensions” mean? หมายถึงการเพิ่มรูปแบบไฟล์แบบกำหนดเองลงในรายการที่ Redactor รองรับเพื่อให้เอนจินจัดการไฟล์เหล่านั้นเป็นไฟล์พร้อมทำลบข้อมูล
  • Do I need a license? ใช่ – เวอร์ชันทดลองใช้ได้สำหรับการพัฒนา แต่การใช้งานจริงต้องมีไลเซนส์ GroupDocs.Redaction ที่ซื้อแล้ว
  • Which .NET versions are supported? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6/7.
  • Can I add multiple extensions at once? แน่นอน – เพียงแค่คั่นด้วยเครื่องหมายคอมม่าในไฟล์กำหนดค่า
  • Is performance impacted? ไม่, GroupDocs.Redaction ประมวลผลส่วนขยายที่กำหนดเองด้วยเอนจินที่ปรับแต่งแล้วเช่นเดียวกัน รองรับไฟล์ขนาดสูงสุด 2 GB โดยไม่ต้องโหลดเอกสารทั้งหมดเข้าสู่หน่วยความจำ

อะไรคือ “how to extend extensions”?

“How to extend extensions” หมายถึงกระบวนการลงทะเบียนส่วนต่อท้ายไฟล์เพิ่มเติมเพื่อให้ GroupDocs.Redaction รับรู้ว่าเป็นอินพุตที่ถูกต้องสำหรับการทำลบข้อมูล โดยการอัปเดต RedactorConfiguration คุณสั่งให้ไลบรารีจัดการไฟล์เช่น .dump เช่นเดียวกับไฟล์ PDF หรือ DOCX ดั้งเดิม

ทำไมต้องขยายส่วนขยายด้วย GroupDocs.Redaction?

GroupDocs.Redaction รองรับรูปแบบทั่วไป 30+ รูปแบบแล้วรวมถึง PDF, DOCX, PPTX และประเภทภาพต่าง ๆ การขยายส่วนขยายทำให้คุณครอบคลุมรูปแบบเฉพาะหรือรูปแบบเก่าที่องค์กรของคุณพึ่งพาได้โดยไม่ต้องทำขั้นตอนการแปลงล่วงหน้าที่มีค่าใช้จ่าย คำอ้างอิงเชิงปริมาณ: เอนจินสามารถประมวลผลไฟล์ 2 GB พร้อมรักษาการใช้หน่วยความจำไม่เกิน 150 MB ด้วยสถาปัตยกรรมสตรีมมิง

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบว่าคุณมีสิ่งต่อไปนี้:

  • GroupDocs.Redaction library installed in your .NET solution (latest stable version).
  • Visual Studio 2022 หรือ IDE ที่เข้ากันได้
  • ความรู้พื้นฐาน C# และความคุ้นเคยกับการทำ I/O ของไฟล์ใน .NET
  • ไลเซนส์ GroupDocs.Redaction ที่ใช้งานได้ (ทดลองสำหรับการทดสอบ, ซื้อสำหรับการใช้งานจริง)

ไลบรารีและการพึ่งพาที่จำเป็น

  • GroupDocs.Redaction – core redaction engine.

การตั้งค่าสภาพแวดล้อม

  • Windows 10/11 หรือระบบปฏิบัติการใด ๆ ที่ .NET Core รองรับ
  • .NET SDK 6.0+ แนะนำสำหรับโปรเจกต์ใหม่

ความรู้เบื้องต้นที่จำเป็น

  • ความเข้าใจว่าด้วยวิธีที่ .NET จัดการส่วนต่อท้ายไฟล์ (Path.GetExtension)
  • ความคุ้นเคยกับคลาส RedactorConfiguration และคุณสมบัติ Settings ของมัน

วิธีขยายส่วนขยายใน GroupDocs.Redaction .NET?

RedactorConfiguration คือคลาสที่เก็บการตั้งค่า runtime สำหรับเอนจิน GroupDocs.Redaction.
Redactor คือคลาสที่ทำการลบข้อมูลตามการกำหนดค่าที่ให้มา.
ExtensionFilter เป็นคุณสมบัติของการกำหนดค่าที่ระบุว่าส่วนต่อท้ายไฟล์ใดจะได้รับการรับรู้.

โหลดการกำหนดค่าของคุณ, เพิ่มส่วนต่อท้ายใหม่, และรันการลบข้อมูล – นี่คือขั้นตอนทำงานทั้งหมดใน สี่ขั้นตอนสั้นกระชับ คำตอบคือ: สร้าง RedactorConfiguration, แก้ไข Settings.ExtensionFilter เพื่อรวมส่วนต่อท้ายที่กำหนดเองของคุณ, สร้างอินสแตนซ์ Redactor ด้วยการกำหนดค่านั้น, และเรียก Redactor.Redact() บนไฟล์เป้าหมาย.

ขั้นตอน 1: ติดตั้งไลบรารี GroupDocs.Redaction

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI – ค้นหา “GroupDocs.Redaction” แล้วติดตั้งเวอร์ชันล่าสุด

ขั้นตอน 2: รับไลเซนส์

  1. Free Trial – ดาวน์โหลดคีย์ชั่วคราวจาก official site.
  2. Temporary License – ขอคีย์ผ่านพอร์ทัลหากต้องการคีย์ระยะสั้น.
  3. Purchase – สำหรับการใช้งานผลิตภัณฑ์ไม่จำกัด ให้ซื้อไลเซนส์เชิงพาณิชย์

ขั้นตอน 3: กำหนดค่า Redactor ให้รับรู้ส่วนขยายแบบกำหนดเอง

คลาส RedactorConfiguration กำหนดการตั้งค่า runtime ทั้งหมดสำหรับเอนจินการลบข้อมูล.

// Definition anchor
RedactorConfiguration config = new RedactorConfiguration();

// Add custom extension support
config.Settings.ExtensionFilter = "*.pdf;*.docx;*.dump";

Explanation:

  • RedactorConfiguration คือจุดเริ่มต้นสำหรับตัวเลือกการลบข้อมูลทั้งหมด.
  • ExtensionFilter รับรายการรูปแบบไวลด์การ์ดที่คั่นด้วยเซมิโคลอน; การเพิ่ม “*.dump” บอกเอนจินให้จัดการไฟล์ .dump เป็นไฟล์ที่รองรับ.

ขั้นตอน 4: ใช้การลบข้อมูลกับไฟล์ที่มีส่วนขยายใหม่

คลาส Redactor ทำงานลบข้อมูลจริง.

// Definition anchor
Redactor redactor = new Redactor(config);

// Perform redaction
redactor.Redact("sample.dump", "sample_redacted.dump");

Explanation:

  • Redactor ใช้การกำหนดค่าที่คุณเตรียมไว้.
  • เมธอด Redact อ่านไฟล์ต้นทาง, ใช้กฎการลบข้อมูลที่กำหนด, แล้วเขียนผลลัพธ์ที่ทำความสะอาดแล้วออกมา.

เคล็ดลับการแก้ไขปัญหา

  • Incorrect path: ตรวจสอบว่าเส้นทางไฟล์ต้นทางเป็นแบบเต็มหรือสัมพันธ์อย่างถูกต้องกับไดเรกทอรีที่กำลังทำงาน.
  • Extension not recognised: ตรวจสอบอีกครั้งว่ารูปแบบที่คุณเพิ่มตรงกับส่วนต่อท้ายของไฟล์อย่างแม่นยำ (ไม่สนใจตัวพิมพ์ใหญ่/เล็ก).
  • License errors: ตรวจสอบว่าไฟล์ไลเซนส์โหลดก่อนการเรียกใช้การลบข้อมูล มิฉะนั้นไลบรารีจะกลับไปใช้โหมดทดลองที่มีฟีเจอร์จำกัด.

การประยุกต์ใช้งานจริง

  1. Legal Document Processing – บริษัทกฎหมายหลายแห่งเก็บไฟล์คดีในรูปแบบกรรมสิทธิ์ .case; การเพิ่ม “*.case” ทำให้คุณสามารถลบข้อมูลลับของลูกค้าโดยไม่ต้องแปลงไฟล์ก่อน.
  2. Financial Reporting – รายงานไตรมาสมักมาถึงในไฟล์ที่ตั้งชื่อแบบกำหนดเอง .finrep; ด้วยการเปลี่ยนแปลงการกำหนดค่าเดียวคุณสามารถลบข้อมูลส่วนบุคคล (PII) ก่อนการเก็บถาวรได้อัตโนมัติ.
  3. Workflow Automation – ระบบจัดการเนื้อหาองค์กรอาจใส่แท็กไฟล์ด้วยส่วนต่อท้ายแบบกำหนดเอง (เช่น .wfdoc). การขยายส่วนขยายทำให้ขั้นตอนการลบข้อมูลอยู่ในไพป์ไลน์เดียวกัน ลดความหน่วงและภาระการจัดเก็บ.

ข้อพิจารณาด้านประสิทธิภาพ

  • Resource optimisation: ควรเรียก redactor.Dispose() เสมอหรือห่อวัตถุในบล็อก using เพื่อปล่อยไฟล์แฮนด์เดิลโดยเร็ว.
  • Memory footprint: ไลบรารีสตรีมข้อมูล ดังนั้นไฟล์ขนาด 2 GB ก็ใช้หน่วยความจำต่ำกว่า 150 MB.
  • Batch processing: ประมวลผลชุดไฟล์แบบขนานด้วย Parallel.ForEach แต่จำกัดความพร้อมกันให้เท่ากับจำนวนคอร์ของ CPU เพื่อหลีกเลี่ยงคอขวด I/O.

คำอ้างอิงเชิงปริมาณ: ในการทดสอบเบนช์มาร์คบน VM 8‑คอร์มาตรฐาน การลบข้อมูล PDF ขนาด 500 MB ใช้เวลา ต่ำกว่า 4 วินาที ต่อไฟล์, และไฟล์ที่มีส่วนขยายแบบกำหนดเองทำงานเช่นเดียวกัน.

คำถามที่พบบ่อย

Q: Can I extend support for multiple custom extensions at once?
A: ใช่ – เพียงคั่นแต่ละรูปแบบด้วยเซมิโคลอนใน settings.ExtensionFilter, เช่น "*.dump;*.xyz;*.custom".

Q: How do I handle errors during redaction?
A: ห่อการเรียก Redact ด้วยบล็อก try‑catch, บันทึกข้อยกเว้น, และอาจลองใหม่ด้วยอินสแตนซ์ Redactor ใหม่.

Q: What are the system requirements for GroupDocs.Redaction?
A: .NET Framework 4.6+ หรือ .NET Core 3.1+; runtime บน Windows, Linux หรือ macOS; และ RAM อย่างน้อย 2 GB สำหรับการประมวลผลไฟล์ขนาดใหญ่.

Q: Is there a limit to how many files I can redact at once?
A: ไม่มีขีดจำกัดที่แน่นอน, แต่การประมวลผลเป็นชุดละ 50–100 ไฟล์ช่วยสมดุลการใช้หน่วยความจำและอัตราการทำงาน.

Q: How do I contribute to the GroupDocs community?
A: เข้าร่วมการสนทนาที่ GroupDocs Forum และแบ่งปันส่วนขยายหรือโค้ดตัวอย่างของคุณ.

แหล่งข้อมูล

อัปเดตล่าสุด: 2026-07-25
ทดสอบด้วย: GroupDocs.Redaction 23.12 for .NET
ผู้เขียน: GroupDocs

using GroupDocs.Redaction;
using GroupDocs.Redaction.Configuration;

// Initialize the Redactor configuration instance.
RedactorConfiguration config = RedactorConfiguration.GetInstance();

// Step 1: Obtain configuration instance.
RedactorConfiguration config = RedactorConfiguration.GetInstance();

// Step 2: Configure the document format settings.
DocumentFormatConfiguration settings = config.FindFormat(".txt");
settings.ExtensionFilter += ",.dump"; // Add '.dump' to supported extensions list.

string sourceFile = "YOUR_DOCUMENT_DIRECTORY\\sample.dump";

using (Redactor redactor = new Redactor(sourceFile))
{
    // Step 3: Execute an exact phrase redaction.
    redactor.Apply(new ExactPhraseRedaction("dolor", false, new ReplacementOptions("[redacted]")));
    
    // Save the changes to a specified output directory.
    var outputFile = redactor.Save();
    Console.WriteLine($"File saved to {outputFile}.");
}

บทแนะนำที่เกี่ยวข้อง