GroupDocs.Redaction برای .NET 26.6 اکنون در دسترس است. این نسخه باز کردن اسناد از جریان‌ها و فایل‌ها با فرمت صریح را آسان‌تر می‌کند و یک API رسم جدید معرفی می‌کند که مستقل از System.Drawing است تا سازگاری چندپلتفرمی بهبود یابد.

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

  • [بهبود] هنگام باز کردن سند از یک جریان یا مسیر فایل، نوع فایل را مشخص کنید. (REDACTIONNET-572)
  • [بهبود] مهاجرت از System.Drawing برای ارتقاء سازگاری چندپلتفرمی. (REDACTIONNET-799)

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

این انتشار بر دو حوزه متمرکز است که ادغام را ساده‌تر می‌کند و API را برای پشتیبانی گسترده‌تر از پلتفرم‌ها آماده می‌سازد.

مشخص کردن فرمت سند با LoadOptions.FileType

هنگامی که یک سند را باز می‌کنید، GroupDocs.Redaction به‌طور معمول فرمت آن را به‌صورت خودکار تشخیص می‌دهد. این کار برای فایل‌هایی که پسوند صحیح دارند خوب عمل می‌کند، اما برای جریان‌هایی که نام فایل ندارند یا زمانی که پسوند با محتوای واقعی مطابقت ندارد، ممکن است شکست بخورد.

نسخه 26.6 ویژگی LoadOptions.FileType و سازنده LoadOptions(FileType) را اضافه می‌کند. FileType را به یک ثابت پشتیبانی‌شده مانند FileType.DOCX یا FileType.PDF تنظیم کنید و کتابخانه سند را با استفاده از آن فرمت باز می‌کند بدون اینکه تشخیص فرمت باینری انجام شود. رفتار پیش‌فرض زمانی که FileType مشخص نشود یا برابر FileType.Unknown باقی بماند، تغییر نمی‌کند.

انواع رسم چندپلتفرمی در GroupDocs.Redaction.Options.Drawing

چندین گزینهٔ رد کردن قبلاً به انواع System.Drawing (Color، Point، Size، Rectangle، Font) وابسته بودند. این انواع در همهٔ پلتفرم‌ها موجود نیستند و می‌توانند استقرار بر روی لینوکس و محیط‌های کانتینری را پیچیده کنند.

فضای‌نام جدید GroupDocs.Redaction.Options.Drawing انواع Color، Point، Size، Rectangle، Font و FontStyle را برای استفاده در API عمومی فراهم می‌کند. بارگذاری‌های جدید این انواع را در ReplacementOptions، RegionReplacementOptions، ImageAreaRedaction، PageAreaFilter، TextFragment و کلاس‌های مرتبط می‌پذیرند.

کدهای موجود که از System.Drawing استفاده می‌کنند همچنان کامپایل و اجرا می‌شوند. اعضای مربوطه به‌عنوان منسوخ علامت‌گذاری شده‌اند و باید در به‌روزرسانی‌های آینده به انواع جدید منتقل شوند.

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

افزوده شد

  • ویژگی LoadOptions.FileType
  • سازنده LoadOptions(FileType fileType)
  • انواع رسم در GroupDocs.Redaction.Options.Drawing: Color، Point، Size، Rectangle، Font، FontStyle
  • بارگذاری‌های جدید که انواع GroupDocs.Redaction.Options.Drawing را می‌پذیرند

منسوخ شد

  • ReplacementOptions.BoxColor — به جای آن از ReplacementOptions.BoxFillColor استفاده کنید
  • ReplacementOptions(System.Drawing.Color) — به جای آن از ReplacementOptions(GroupDocs.Redaction.Options.Drawing.Color) استفاده کنید
  • RegionReplacementOptions.FillColor — به جای آن از RegionReplacementOptions.AreaFillColor استفاده کنید
  • RegionReplacementOptions.Size — به جای آن از RegionReplacementOptions.AreaSize استفاده کنید
  • RegionReplacementOptions(System.Drawing.Color, System.Drawing.Size) — به جای آن از بارگذاری با GroupDocs.Redaction.Options.Drawing.Color و GroupDocs.Redaction.Options.Drawing.Size استفاده کنید
  • RegionReplacementOptions(System.Drawing.Color, System.Drawing.Font, string) — به جای آن از بارگذاری با GroupDocs.Redaction.Options.Drawing.Color و GroupDocs.Redaction.Options.Drawing.Font استفاده کنید
  • ImageAreaRedaction.TopLeft — به جای آن از ImageAreaRedaction.TopLeftPosition استفاده کنید
  • ImageAreaRedaction(System.Drawing.Point, RegionReplacementOptions) — به جای آن از بارگذاری با GroupDocs.Redaction.Options.Drawing.Point استفاده کنید
  • PageAreaFilter.Rectangle — به جای آن از PageAreaFilter.AreaRectangle استفاده کنید
  • PageAreaFilter(System.Drawing.Point, System.Drawing.Size) — به جای آن از بارگذاری با GroupDocs.Redaction.Options.Drawing.Point و GroupDocs.Redaction.Options.Drawing.Size استفاده کنید
  • TextFragment.Rectangle — به جای آن از TextFragment.BoundingRectangle استفاده کنید
  • TextFragment(string, System.Drawing.Rectangle) — به جای آن از TextFragment(string, GroupDocs.Redaction.Options.Drawing.Rectangle) استفاده کنید
  • IImageFormatInstance.EditArea(System.Drawing.Point, RegionReplacementOptions) — به جای آن از بارگذاری با GroupDocs.Redaction.Options.Drawing.Point استفاده کنید

مثال‌های کد

باز کردن سند با نوع فایل صریح

using System.IO;
using GroupDocs.Redaction.Options;
using GroupDocs.Redaction.Redactions;

using (Stream stream = File.OpenRead("sample.docx"))
{
    using (Redactor redactor = new Redactor(stream, new LoadOptions(FileType.DOCX)))
    {
        redactor.Apply(new DeleteAnnotationRedaction());
        redactor.Save();
    }
}

using (Redactor redactor = new Redactor("sample.pdf", new LoadOptions(FileType.PDF)))
{
    redactor.Apply(new ExactPhraseRedaction("Test", new ReplacementOptions("[redacted]")));
    redactor.Save();
}

استفاده از GroupDocs.Redaction.Options.Drawing به‌جای System.Drawing

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

// قبلاً: new ReplacementOptions(System.Drawing.Color.Red)
using (Redactor redactor = new Redactor("sample.docx"))
{
    redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(Color.Red)));
    redactor.Save();
}

// قبلاً: new ImageAreaRedaction(new System.Drawing.Point(516, 311),
//     new RegionReplacementOptions(System.Drawing.Color.Blue, new System.Drawing.Size(170, 35)))
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.6 دریافت کنید

بیشتر بدانید