ما خوشحالیم که انتشار GroupDocs.Comparison برای .NET نسخه 26.4 را اعلام می‌کنیم، که از آوریل 2026 در دسترس است.
نسخه 26.4 از GroupDocs.Comparison بر بهبودهای قابل توجه در مقایسه اسناد PDF متمرکز است و حالت‌های نمایش جدید، فیلتر کردن بازه صفحات و یک کلاس گزینه‌های اختصاصی PDF را معرفی می‌کند.

Fixes and enhancements

  • [Enhancement] بهینه‌سازی عملکرد مقایسه برای اسناد PDF. (COMPARISONNET-4732)
  • [Bug] رفع منطق پردازش فونت‌های جاسازی‌شده در مقایسه PDF. (COMPARISONNET-4733)
  • [Bug] خطا هنگام پردازش PDF حاوی جداول. (COMPARISONNET-4707)
  • [Feature] قابلیت تولید نتیجه مقایسه PDF به صورت کنار هم. (COMPARISONNET-4725)
  • [Feature] قابلیت تعیین بازه صفحات برای مقایسه اسناد PDF. (COMPARISONNET-4731)

Major Features

Ability to produce side by side PDF comparison result

دو حالت نمایش جدید به کلاس جدید PdfCompareOptions از طریق enum ComparisonDisplayMode اضافه شده‌اند:

  • SideBySide – هر صفحهٔ نتیجه، صفحات منبع و هدف را به صورت کنار هم نشان می‌دهد. حذف‌ها در سمت چپ (سمت منبع) و افزودن‌ها در سمت راست (سمت هدف) نمایش داده می‌شوند. محتواهای دو سند هرگز روی هم قرار نمی‌گیرند، بنابراین این حالت برای اسنادی که تفاوت‌های زیادی دارند ایده‌آل است.
  • Interleaved – سندی با صفحات متناوب تولید می‌کند: صفحات با شمارهٔ فرد از سند منبع (حذف‌ها) و صفحات با شمارهٔ زوج از سند هدف (افزودن‌ها) می‌آیند. برای مشاهدهٔ هر جفت منبع/هدف به صورت کنار هم، نتیجه را در یک نمایشگر PDF با حالت «نمای دو صفحه» باز کنید.

Note: رفتار پیش‌فرض قبلی (یک سند ترکیبی با برجسته‌سازی افزودن‌ها و حذف‌ها) به عنوان ComparisonDisplayMode.Inline حفظ شده و همچنان مقدار پیش‌فرض است.

Ability to specify pages range for PDF documents comparison

اکنون می‌توانید مقایسه PDF را به یک بازهٔ خاص از صفحات محدود کنید با استفاده از ویژگی PagesSetup در PdfCompareOptions. اگر تنظیم نشود، تمام صفحات همانند قبل مقایسه می‌شوند.

using (var comparer = new Comparer("source.pdf"))
{
    comparer.Add("target.pdf");

    var options = new PdfCompareOptions()
    {
        CompareImagesPdf = true,
        DisplayMode = PdfCompareOptions.ComparisonDisplayMode.SideBySide,
        PagesSetup = new PagesSetup()
        {
            StartPage = 3,
            EndPage = 10
        }
    };

    comparer.Compare("result.pdf", options);
}

Public API changes

یک کلاس جدید PdfCompareOptions برای پیکربندی مقایسه مخصوص PDF معرفی شده است که الگوی مشابهی با WordCompareOptions که در نسخهٔ 26.2 معرفی شد، دارد.

  • PdfCompareOptions (فضای نام GroupDocs.Comparison.Options) — از CompareOptions ارث می‌برد و تنظیمات مخصوص PDF را اضافه می‌کند:

    • DisplayMode – نحوهٔ چیدمان سند نتیجهٔ مقایسه PDF را کنترل می‌کند؛ مقدار پیش‌فرض Inline (رفتار قدیمی) است
    • PagesSetup – بازهٔ صفحات برای مقایسه را مشخص می‌کند؛ وقتی null باشد، تمام صفحات مقایسه می‌شوند
    • CompareImagesPdf – آیا تصاویر در اسناد PDF مقایسه شوند یا نه
    • AnnotationAuthorName – نام نویسندهٔ حاشیه‌نویسی‌ها وقتی DisplayMode روی Interleaved تنظیم شده باشد
    • ImagesInheritanceMode – منبع ارث‌بری تصویر را زمانی که مقایسه تصویر غیرفعال باشد، تعیین می‌کند
  • PdfCompareOptions.ComparisonDisplayMode مقادیر enum:

    • Inline (پیش‌فرض) – رفتار قدیمی؛ یک PDF ترکیبی با محتوای حذف‌شده به رنگی و محتوای افزوده‌شده به رنگی دیگر برجسته می‌شود
    • SideBySide (جدید) – صفحات منبع و هدف در هر صفحهٔ نتیجه به صورت کنار هم نمایش داده می‌شوند؛ هیچ‌گونه همپوشانی محتوا وجود ندارد
    • Interleaved (جدید) – صفحات متناوب منبع/هدف؛ بهترین نمایش در یک خواننده PDF با حالت «نمای دو صفحه»

How to get the update

می‌توانید آخرین نسخه را از NuGet دریافت کنید یا مستقیماً از وب‌سایت GroupDocs دانلود کنید.

NuGet

GroupDocs.Comparison for .NET 26.4

Direct download

دستگاه‌های اجرایی برای .NET و .NET Framework را از صفحهٔ GroupDocs.Comparison for .NET 26.4 دانلود کنید.

Learn more