วิธีการยกเลิกการตรวจสอบเอกสารโดยใช้ GroupDocs.Signature สำหรับ .NET: คู่มือการจัดการเหตุการณ์

การแนะนำ

คุณกำลังมองหาวิธีที่มีประสิทธิภาพในการจัดการงานตรวจสอบเอกสารที่ใช้เวลานานอยู่ใช่ไหม? ด้วย GroupDocs.Signature สำหรับ .NET คุณสามารถจัดการเหตุการณ์ความคืบหน้าเพื่อตรวจสอบและควบคุมกระบวนการเหล่านี้ได้อย่างมีประสิทธิภาพ คู่มือนี้จะแสดงวิธีการใช้ระบบที่ยกเลิกการดำเนินการตามเงื่อนไขเฉพาะ เช่น เวลาในการประมวลผลเกินขีดจำกัดที่กำหนด

ในบทความนี้เราจะสำรวจ:

  • การตั้งค่าและติดตั้ง GroupDocs.Signature สำหรับ .NET
  • การนำการจัดการเหตุการณ์ความคืบหน้าไปใช้ในแอปพลิเคชันของคุณ
  • การยกเลิกกระบวนการตามเงื่อนไขเฉพาะ
  • การประยุกต์ใช้คุณสมบัติเหล่านี้ในโลกแห่งความเป็นจริง

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

ไลบรารีและการอ้างอิงที่จำเป็น

หากต้องการปฏิบัติตามคู่มือนี้ โปรดแน่ใจว่าคุณมี:

  • GroupDocs.Signature สำหรับ .NET:ไลบรารีหลักสำหรับลายเซ็นเอกสาร
  • .NET Framework หรือ .NET Core:ขอแนะนำเวอร์ชัน 4.6.1 ขึ้นไป

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

ตรวจสอบให้แน่ใจว่าสภาพแวดล้อมการพัฒนาของคุณได้รับการตั้งค่าด้วย Visual Studio หรือ IDE ที่เข้ากันได้ซึ่งรองรับโครงการ .NET

ข้อกำหนดเบื้องต้นของความรู้

ความคุ้นเคยกับ C# และความรู้พื้นฐานเกี่ยวกับการจัดการเหตุการณ์ใน .NET จะเป็นประโยชน์ แต่ไม่ใช่สิ่งบังคับ เนื่องจากเราจะครอบคลุมสิ่งสำคัญๆ ไว้ที่นี่

การตั้งค่า GroupDocs.Signature สำหรับ .NET

ในการเริ่มต้น ให้ติดตั้งไลบรารี GroupDocs.Signature โดยใช้หนึ่งในวิธีต่อไปนี้:

.NET CLI

dotnet add package GroupDocs.Signature

ตัวจัดการแพ็คเกจ

Install-Package GroupDocs.Signature

UI ตัวจัดการแพ็คเกจ NuGet ค้นหา “GroupDocs.Signature” และติดตั้งเวอร์ชันล่าสุด

การได้มาซึ่งใบอนุญาต

คุณสามารถขอรับสิทธิ์ใช้งานแบบทดลองใช้ฟรีเพื่อทดสอบความสามารถทั้งหมดของ GroupDocs.Signature สำหรับการใช้งานจริง คุณอาจพิจารณาซื้อสิทธิ์ใช้งาน:

  • ทดลองใช้ฟรี:เหมาะสำหรับการทดสอบและการพัฒนาเบื้องต้น
  • ใบอนุญาตชั่วคราว:มีประโยชน์หากคุณต้องการเวลาเพิ่มเติมนอกเหนือจากช่วงทดลองใช้งานเพื่อการประเมินผล
  • ซื้อ:รับใบอนุญาตเต็มรูปแบบสำหรับโครงการเชิงพาณิชย์ระยะยาว

การเริ่มต้นขั้นพื้นฐาน

เมื่อติดตั้งแล้ว ให้เริ่มต้น GroupDocs.Signature ในโครงการของคุณเพื่อเริ่มทำงานกับลายเซ็นเอกสาร:

using GroupDocs.Signature;

การตั้งค่านี้ช่วยให้คุณสร้างอินสแตนซ์ของ Signature และเริ่มสำรวจคุณสมบัติของมัน

คู่มือการใช้งาน

เราจะแบ่งการใช้งานออกเป็นส่วนๆ ที่จัดการได้ โดยเน้นที่ฟังก์ชันการทำงานที่แตกต่างกัน

คุณสมบัติ 1: การจัดการเหตุการณ์ความคืบหน้า

ความสามารถในการจัดการเหตุการณ์ความคืบหน้าช่วยให้คุณสามารถติดตามกระบวนการที่กำลังดำเนินอยู่ได้ นี่คือวิธีที่คุณสามารถนำฟีเจอร์นี้ไปใช้:

ภาพรวม

คุณลักษณะนี้ช่วยให้แอปพลิเคชันของคุณตอบสนองต่อการเปลี่ยนแปลงในความคืบหน้าของกระบวนการได้ โดยมีกลไกในการยกเลิกการดำเนินการหากจำเป็น

การดำเนินการแบบทีละขั้นตอน

3.1 การตั้งค่าตัวจัดการเหตุการณ์ ขั้นแรก กำหนดวิธีการจัดการเหตุการณ์ที่จะตรวจสอบว่าเวลาในการประมวลผลเกิน 100 มิลลิวินาที (0.1 วินาที) หรือไม่

private static void OnVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    // ตรวจสอบว่าเวลาในการประมวลผลเกิน 350 ติ๊กหรือไม่
    if (args.Ticks > 350) 
    {
        args.Cancel = true; // ยกเลิกกระบวนการ
        Console.WriteLine("Sign progress was canceled. Time spent {0} mlsec", args.Ticks);
    }
}

3.2 การแนบตัวจัดการเหตุการณ์ ขั้นต่อไปให้แนบตัวจัดการเหตุการณ์นี้กับของคุณ Signature อินสแตนซ์ภายในวิธีการตรวจสอบของคุณ

using (Signature signature = new Signature(filePath))
{
    // แนบตัวจัดการเหตุการณ์สำหรับเหตุการณ์ความคืบหน้า
    signature.VerifyProgress += OnVerifyProgress;

    ...
}

3.3 การดำเนินการตามกระบวนการตรวจสอบ สุดท้ายให้ดำเนินการตรวจสอบเอกสารขณะจัดการกับการยกเลิกที่อาจเกิดขึ้น:

// ดำเนินการตามกระบวนการตรวจสอบ
VerificationResult result = signature.Verify(options);

if (result.IsValid)
{
    Console.WriteLine("Document verification was not canceled!");
}
else
{
    Console.WriteLine("Document verification was canceled successfully!");
}

คุณสมบัติที่ 2: การตรวจสอบเอกสารพร้อมการยกเลิก

ส่วนนี้มุ่งเน้นที่การตรวจสอบเอกสารพร้อมทั้งรวมการจัดการเหตุการณ์ความคืบหน้าสำหรับการยกเลิก

ภาพรวม

โดยการตั้งค่าตัวเลือกการตรวจยืนยันและแนบตัวจัดการความคืบหน้า คุณสามารถยกเลิกกระบวนการได้หากใช้เวลานานเกินไป และทำให้แน่ใจว่าแอปพลิเคชันของคุณยังคงตอบสนองได้

4.1 กำหนดตัวเลือกการตรวจสอบ ตั้งค่า TextVerifyOptions เพื่อระบุว่าด้านใดของเอกสารที่ต้องได้รับการตรวจสอบ:

TextVerifyOptions options = new TextVerifyOptions("Text signature")
{
    // สามารถระบุการกำหนดค่าเพิ่มเติมได้ที่นี่
};

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

การทำความเข้าใจว่าการจัดการและการยกเลิกเหตุการณ์ความคืบหน้าจะส่งผลดีต่อแอปพลิเคชันของคุณอย่างไรนั้นเป็นสิ่งสำคัญ ต่อไปนี้คือกรณีการใช้งานบางส่วน:

  1. การประมวลผลแบบแบตช์:จัดการเวลาในการประมวลผลอย่างมีประสิทธิภาพในสถานการณ์ที่ต้องมีการตรวจยืนยันเอกสารหลายฉบับ
  2. ระบบการตอบรับจากผู้ใช้:ให้ข้อมูลตอบรับแบบเรียลไทม์แก่ผู้ใช้เมื่อการดำเนินการใช้เวลานานกว่าที่คาดไว้ เพื่อปรับปรุงประสบการณ์ของผู้ใช้
  3. การจัดการทรัพยากร:ยกเลิกงานที่ต้องดำเนินการเป็นเวลานานโดยอัตโนมัติ ซึ่งอาจทำให้ทรัพยากรระบบตึงเครียด
  4. การบูรณาการกับระบบอัตโนมัติเวิร์กโฟลว์:ใช้คุณลักษณะเหล่านี้ภายในเวิร์กโฟลว์อัตโนมัติขนาดใหญ่เพื่อให้แน่ใจว่าการทำงานราบรื่นโดยไม่มีความล่าช้า
  5. สภาพแวดล้อมการทดสอบและการพัฒนา:ทดสอบอย่างรวดเร็วว่าแอปพลิเคชันของคุณจัดการกับสถานการณ์การประมวลผลที่แตกต่างกันอย่างไร

การพิจารณาประสิทธิภาพ

การเพิ่มประสิทธิภาพการทำงานเมื่อใช้ GroupDocs.Signature ถือเป็นสิ่งสำคัญสำหรับการรักษาการทำงานที่มีประสิทธิภาพ:

  • การใช้ทรัพยากร:ควรคำนึงถึงการใช้งานหน่วยความจำ โดยเฉพาะเมื่อต้องจัดการเอกสารขนาดใหญ่

  • แนวทางปฏิบัติที่ดีที่สุด-

    • กำจัดทิ้ง Signature วัตถุจะปลดปล่อยทรัพยากรทันที
    • ใช้เหตุการณ์การยกเลิกอย่างรอบคอบเพื่อป้องกันการประมวลผลที่ไม่จำเป็น

บทสรุป

ในบทช่วยสอนนี้ คุณจะได้เรียนรู้วิธีการนำการจัดการเหตุการณ์ความคืบหน้าและการยกเลิกกระบวนการไปใช้ในการตรวจสอบเอกสารโดยใช้ GroupDocs.Signature สำหรับ .NET เทคนิคเหล่านี้สามารถเพิ่มประสิทธิภาพและการตอบสนองของแอปพลิเคชันของคุณได้อย่างมาก

ขั้นตอนต่อไป ให้พิจารณาสำรวจฟีเจอร์อื่นๆ ที่นำเสนอโดย GroupDocs.Signature เช่น การลงนามดิจิทัลและความสามารถในการค้นหาลายเซ็น เพื่อปรับปรุงโซลูชันการจัดการเอกสารของคุณให้ดียิ่งขึ้น

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

คำถามที่ 1: จุดประสงค์ของการจัดการเหตุการณ์ความคืบหน้าใน GroupDocs.Signature คืออะไร เหตุการณ์ความคืบหน้าช่วยตรวจสอบและควบคุมงานตรวจสอบที่ดำเนินมายาวนาน ทำให้คุณสามารถยกเลิกงานได้หากเกินเกณฑ์เวลาที่กำหนด

คำถามที่ 2: ฉันจะแนบตัวจัดการเหตุการณ์สำหรับความคืบหน้าของกระบวนการได้อย่างไร แนบมันโดยใช้ VerifyProgress กิจกรรมของคุณ Signature ตัวอย่าง.

ไตรมาสที่ 3: สถานการณ์ทั่วไปที่การยกเลิกการประมวลผลเอกสารมีประโยชน์มีอะไรบ้าง มีประโยชน์ในการประมวลผลแบบแบตช์ ระบบการตอบรับของผู้ใช้ และการจัดการทรัพยากรเพื่อรักษาประสิทธิภาพของระบบ

ไตรมาสที่ 4: ฉันสามารถปรับเกณฑ์เวลาสำหรับการยกเลิกกระบวนการได้หรือไม่ ใช่ แก้ไขเงื่อนไขภายในวิธีจัดการเหตุการณ์ของคุณ (เช่น args.Ticks > 350) ให้เหมาะกับความต้องการของคุณ

คำถามที่ 5: ฉันควรทำอย่างไรหากแอปพลิเคชันของฉันจำเป็นต้องจัดการเอกสารหลายประเภท? GroupDocs.Signature รองรับรูปแบบเอกสารหลากหลาย ตรวจสอบให้แน่ใจว่าคุณได้กำหนดค่าตัวเลือกการตรวจสอบที่เหมาะสมสำหรับแต่ละประเภทเอกสาร

ทรัพยากร