GroupDocs.Redaction for .NET 26.9 هم‌اکنون در دسترس است. این نسخه وابستگی System.Drawing.Common را از بسته‌های .NET 6، .NET 8 و .NET 10 حذف کرده و سازگاری چند‑پلتفرمی را با لینوکس و سایر سیستم‌عامل‌های پشتیبانی‌شده بهبود می‌بخشد.

اصلاحات و بهبودها

  • [Enhancement] مهاجرت از System.Drawing برای ارتقاء سازگاری چند‑پلتفرمی. (REDACTIONNET-799)

چه چیز جدیدی اضافه شده؟

نسخه 26.9 مهاجرت از System.Drawing را کامل می‌کند. انواع System.Drawing از API عمومی حذف شده‌اند. کد داخلی همچنان برای پردازش اسناد در .NET Framework 4.6.2 از System.Drawing استفاده می‌کند.

بسته‌های چند‑پلتفرمی بدون System.Drawing.Common

بسته‌های .NET 6، .NET 8 و .NET 10 دیگر به System.Drawing.Common وابسته نیستند. پردازش اسناد نیازی به GDI+ یا libgdiplus ندارد. نسخهٔ .NET Framework 4.6.2 همچنان از پشته Windows GDI+ استفاده می‌کند.

انواع System.Drawing از API عمومی حذف شدند

مقادیر رنگ، نقطه، اندازه، مستطیل و قلم اکنون فقط از GroupDocs.Redaction.Options.Drawing می‌آیند. کدی که هنوز System.Drawing.Color، System.Drawing.Point، System.Drawing.Size، System.Drawing.Rectangle یا System.Drawing.Font را می‌پذیرد، دیگر کامپایل نمی‌شود.

GroupDocs.Redaction.Options.Drawing.Color همچنان رنگ‌های نام‌دار مانند Color.Black و Color.Blue، به‌علاوه Color.FromName و Color.FromArgb را در اختیار می‌گذارد.

نام‌های اعضای اصلی دوباره به API فعلی بازگشتند. BoxColor، FillColor، Size، TopLeft و Rectangle اکنون از انواع رسم GroupDocs استفاده می‌کنند. نام‌های مستعار موقت که در 26.6 اضافه شده بودند، منسوخ شده‌اند:

نام مستعار منسوخ به جای آن استفاده کنید
ReplacementOptions.BoxFillColor ReplacementOptions.BoxColor
RegionReplacementOptions.AreaFillColor RegionReplacementOptions.FillColor
RegionReplacementOptions.AreaSize RegionReplacementOptions.Size
ImageAreaRedaction.TopLeftPosition ImageAreaRedaction.TopLeft
PageAreaFilter.AreaRectangle PageAreaFilter.Rectangle
TextFragment.BoundingRectangle TextFragment.Rectangle

تغییرات API عمومی

حذف شده

  • اعضای عمومی که در ReplacementOptions، RegionReplacementOptions، ImageAreaRedaction، PageAreaFilter، TextFragment و IImageFormatInstance انواع System.Drawing را می‌پذیرفتند یا برمی‌گرداندند
  • ReplacementOptions(System.Drawing.Color)
  • سازنده‌های RegionReplacementOptions که System.Drawing.Color، System.Drawing.Size یا System.Drawing.Font می‌گرفتند
  • ImageAreaRedaction(System.Drawing.Point, RegionReplacementOptions)
  • PageAreaFilter(System.Drawing.Point, System.Drawing.Size)
  • TextFragment(string, System.Drawing.Rectangle)
  • IImageFormatInstance.EditArea(System.Drawing.Point, RegionReplacementOptions)

API فعلی

  • ReplacementOptions.BoxColor و ReplacementOptions(GroupDocs.Redaction.Options.Drawing.Color)
  • RegionReplacementOptions.FillColor، RegionReplacementOptions.Size و سازنده‌هایی که رنگ، اندازه و قلم از GroupDocs.Redaction.Options.Drawing می‌گیرند
  • ImageAreaRedaction.TopLeft و ImageAreaRedaction(GroupDocs.Redaction.Options.Drawing.Point, RegionReplacementOptions)
  • PageAreaFilter.Rectangle و PageAreaFilter(GroupDocs.Redaction.Options.Drawing.Point, GroupDocs.Redaction.Options.Drawing.Size)
  • TextFragment.Rectangle و TextFragment(string, GroupDocs.Redaction.Options.Drawing.Rectangle)
  • IImageFormatInstance.EditArea(GroupDocs.Redaction.Options.Drawing.Point, RegionReplacementOptions)

منسوخ شده

  • ReplacementOptions.BoxFillColor — به جای آن از ReplacementOptions.BoxColor استفاده کنید
  • RegionReplacementOptions.AreaFillColor — به جای آن از RegionReplacementOptions.FillColor استفاده کنید
  • RegionReplacementOptions.AreaSize — به جای آن از RegionReplacementOptions.Size استفاده کنید
  • ImageAreaRedaction.TopLeftPosition — به جای آن از ImageAreaRedaction.TopLeft استفاده کنید
  • PageAreaFilter.AreaRectangle — به جای آن از PageAreaFilter.Rectangle استفاده کنید
  • TextFragment.BoundingRectangle — به جای آن از TextFragment.Rectangle استفاده کنید

مثال‌های کد

رسم یک جعبه رنگی روی متن مطابق

using GroupDocs.Redaction.Options.Drawing;
using GroupDocs.Redaction.Redactions;

using (Redactor redactor = new Redactor("sample.docx"))
{
    redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(Color.Black)));
    redactor.Save();
}

حذف ناحیه‌ای از یک تصویر

using GroupDocs.Redaction.Options.Drawing;
using GroupDocs.Redaction.Redactions;

using (Redactor redactor = new Redactor("sample.jpg"))
{
    redactor.Apply(new ImageAreaRedaction(
        new Point(516, 311),
        new RegionReplacementOptions(Color.Blue, new Size(170, 35))));
    redactor.Save();
}

نحوه دریافت به‌روزرسانی

  • NuGet – با استفاده از NuGet بستهٔ آخرین GroupDocs.Redaction for .NET را ارتقا دهید
  • دانلود مستقیم – اسمبلی‌های GroupDocs.Redaction را از صفحهٔ GroupDocs.Redaction for .NET 26.9 دریافت کنید

برای اطلاعات بیشتر