GroupDocs.Redaction for .NET 26.9 jest już dostępny. To wydanie usuwa zależność System.Drawing.Common z pakietów .NET 6, .NET 8 i .NET 10 oraz poprawia kompatybilność wieloplatformową z Linuksem i innymi obsługiwanymi systemami operacyjnymi.

Poprawki i udoskonalenia

  • [Udoskonalenie] Migracja z System.Drawing w celu zwiększenia kompatybilności wieloplatformowej. (REDACTIONNET-799)

Co nowego?

Wersja 26.9 kończy migrację z System.Drawing. Typy System.Drawing zostały usunięte z publicznego API. Wewnętrzny kod nadal używa System.Drawing do przetwarzania dokumentów wyłącznie w .NET Framework 4.6.2.

Pakiety wieloplatformowe bez System.Drawing.Common

Pakiety .NET 6, .NET 8 i .NET 10 nie zależą już od System.Drawing.Common. Przetwarzanie dokumentów nie wymaga GDI+ ani libgdiplus. Kompilacja .NET Framework 4.6.2 wciąż korzysta ze stosu Windows GDI+.

Typy System.Drawing usunięte z publicznego API

Wartości koloru, punktu, rozmiaru, prostokąta i czcionki pochodzą teraz wyłącznie z GroupDocs.Redaction.Options.Drawing. Kod, który nadal przekazuje System.Drawing.Color, System.Drawing.Point, System.Drawing.Size, System.Drawing.Rectangle lub System.Drawing.Font, nie będzie się kompilował.

GroupDocs.Redaction.Options.Drawing.Color nadal udostępnia nazwy kolorów, takie jak Color.Black i Color.Blue, a także Color.FromName i Color.FromArgb.

Oryginalne nazwy członków ponownie są aktualnym API. BoxColor, FillColor, Size, TopLeft i Rectangle teraz używają typów rysunkowych GroupDocs. Tymczasowe aliasy dodane w wersji 26.6 są przestarzałe:

Przestarzały alias Zamiast tego użyj
ReplacementOptions.BoxFillColor ReplacementOptions.BoxColor
RegionReplacementOptions.AreaFillColor RegionReplacementOptions.FillColor
RegionReplacementOptions.AreaSize RegionReplacementOptions.Size
ImageAreaRedaction.TopLeftPosition ImageAreaRedaction.TopLeft
PageAreaFilter.AreaRectangle PageAreaFilter.Rectangle
TextFragment.BoundingRectangle TextFragment.Rectangle

Zmiany w publicznym API

Usunięte

  • Publiczne członki przyjmujące lub zwracające typy System.Drawing w ReplacementOptions, RegionReplacementOptions, ImageAreaRedaction, PageAreaFilter, TextFragment oraz IImageFormatInstance
  • ReplacementOptions(System.Drawing.Color)
  • Konstruktorzy RegionReplacementOptions przyjmujący System.Drawing.Color, System.Drawing.Size lub 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)

Aktualne API

  • ReplacementOptions.BoxColor oraz ReplacementOptions(GroupDocs.Redaction.Options.Drawing.Color)
  • RegionReplacementOptions.FillColor, RegionReplacementOptions.Size oraz konstruktorzy przyjmujący kolor, rozmiar i czcionkę z GroupDocs.Redaction.Options.Drawing
  • ImageAreaRedaction.TopLeft oraz ImageAreaRedaction(GroupDocs.Redaction.Options.Drawing.Point, RegionReplacementOptions)
  • PageAreaFilter.Rectangle oraz PageAreaFilter(GroupDocs.Redaction.Options.Drawing.Point, GroupDocs.Redaction.Options.Drawing.Size)
  • TextFragment.Rectangle oraz TextFragment(string, GroupDocs.Redaction.Options.Drawing.Rectangle)
  • IImageFormatInstance.EditArea(GroupDocs.Redaction.Options.Drawing.Point, RegionReplacementOptions)

Przestarzałe

  • ReplacementOptions.BoxFillColor — użyj ReplacementOptions.BoxColor
  • RegionReplacementOptions.AreaFillColor — użyj RegionReplacementOptions.FillColor
  • RegionReplacementOptions.AreaSize — użyj RegionReplacementOptions.Size
  • ImageAreaRedaction.TopLeftPosition — użyj ImageAreaRedaction.TopLeft
  • PageAreaFilter.AreaRectangle — użyj PageAreaFilter.Rectangle
  • TextFragment.BoundingRectangle — użyj TextFragment.Rectangle

Przykłady kodu

Rysowanie kolorowego prostokąta nad dopasowanym tekstem

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();
}

Redakcja obszaru obrazu

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();
}

Jak uzyskać aktualizację

  • NuGet – Zaktualizuj do najnowszego pakietu GroupDocs.Redaction for .NET za pośrednictwem NuGet
  • Bezpośrednie pobranie – Pobierz zestawy GroupDocs.Redaction ze strony GroupDocs.Redaction for .NET 26.9

Dowiedz się więcej