GroupDocs.Redaction for .NET 26.6 is nu beschikbaar. Deze release maakt het gemakkelijker om documenten te openen vanuit streams en bestanden met een expliciet formaat, en introduceert een nieuwe teken‑API die onafhankelijk is van System.Drawing om de cross‑platform compatibiliteit te verbeteren.

Oplossingen en verbeteringen

  • [Enhancement] Specificeer bestandstype bij het openen van een document vanuit een stream of bestandspad. (REDACTIONNET-572)
  • [Enhancement] Migreer weg van System.Drawing om de cross‑platform compatibiliteit te verbeteren. (REDACTIONNET-799)

Wat is er nieuw?

Deze release richt zich op twee gebieden die integratie vereenvoudigen en de API voorbereiden op bredere platformondersteuning.

Specificeer documentformaat met LoadOptions.FileType

Wanneer u een document opent, detecteert GroupDocs.Redaction normaal gesproken automatisch het formaat. Dat werkt goed voor bestanden met een correcte extensie, maar kan falen voor streams zonder bestandsnaam of wanneer de extensie niet overeenkomt met de daadwerkelijke inhoud.

Versie 26.6 voegt de eigenschap LoadOptions.FileType en een LoadOptions(FileType) constructor toe. Stel FileType in op een ondersteunde constante, zoals FileType.DOCX of FileType.PDF, en de bibliotheek opent het document met dat formaat zonder binaire formaatdetectie uit te voeren. Het standaardgedrag blijft ongewijzigd wanneer FileType niet is opgegeven of FileType.Unknown blijft.

Cross‑platform teken‑types in GroupDocs.Redaction.Options.Drawing

Verschillende redaction‑opties vertrouwden eerder op System.Drawing‑types (Color, Point, Size, Rectangle, Font). Deze types zijn niet op alle platforms beschikbaar en kunnen de implementatie op Linux en in gecontaineriseerde omgevingen bemoeilijken.

De nieuwe namespace GroupDocs.Redaction.Options.Drawing biedt de types Color, Point, Size, Rectangle, Font en FontStyle voor gebruik in de publieke API. Nieuwe overloads accepteren deze types in ReplacementOptions, RegionReplacementOptions, ImageAreaRedaction, PageAreaFilter, TextFragment en gerelateerde klassen.

Bestaande code die System.Drawing gebruikt blijft compileren en uitvoeren. De bijbehorende leden zijn gemarkeerd als verouderd en moeten in toekomstige updates naar de nieuwe types worden gemigreerd.

Wijzigingen in de publieke API

Toegevoegd

  • LoadOptions.FileType eigenschap
  • LoadOptions(FileType fileType) constructor
  • Teken‑types in GroupDocs.Redaction.Options.Drawing: Color, Point, Size, Rectangle, Font, FontStyle
  • Nieuwe overloads die GroupDocs.Redaction.Options.Drawing types accepteren

Verouderd

  • ReplacementOptions.BoxColor — gebruik ReplacementOptions.BoxFillColor in plaats daarvan
  • ReplacementOptions(System.Drawing.Color) — gebruik ReplacementOptions(GroupDocs.Redaction.Options.Drawing.Color) in plaats daarvan
  • RegionReplacementOptions.FillColor — gebruik RegionReplacementOptions.AreaFillColor in plaats daarvan
  • RegionReplacementOptions.Size — gebruik RegionReplacementOptions.AreaSize in plaats daarvan
  • RegionReplacementOptions(System.Drawing.Color, System.Drawing.Size) — gebruik de overload met GroupDocs.Redaction.Options.Drawing.Color en GroupDocs.Redaction.Options.Drawing.Size in plaats daarvan
  • RegionReplacementOptions(System.Drawing.Color, System.Drawing.Font, string) — gebruik de overload met GroupDocs.Redaction.Options.Drawing.Color en GroupDocs.Redaction.Options.Drawing.Font in plaats daarvan
  • ImageAreaRedaction.TopLeft — gebruik ImageAreaRedaction.TopLeftPosition in plaats daarvan
  • ImageAreaRedaction(System.Drawing.Point, RegionReplacementOptions) — gebruik de overload met GroupDocs.Redaction.Options.Drawing.Point in plaats daarvan
  • PageAreaFilter.Rectangle — gebruik PageAreaFilter.AreaRectangle in plaats daarvan
  • PageAreaFilter(System.Drawing.Point, System.Drawing.Size) — gebruik de overload met GroupDocs.Redaction.Options.Drawing.Point en GroupDocs.Redaction.Options.Drawing.Size in plaats daarvan
  • TextFragment.Rectangle — gebruik TextFragment.BoundingRectangle in plaats daarvan
  • TextFragment(string, System.Drawing.Rectangle) — gebruik TextFragment(string, GroupDocs.Redaction.Options.Drawing.Rectangle) in plaats daarvan
  • IImageFormatInstance.EditArea(System.Drawing.Point, RegionReplacementOptions) — gebruik de overload met GroupDocs.Redaction.Options.Drawing.Point in plaats daarvan

Codevoorbeelden

Open een document met een expliciet bestandstype

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

Gebruik GroupDocs.Redaction.Options.Drawing in plaats van System.Drawing

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

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

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

Hoe de update te verkrijgen

  • NuGet – Upgrade naar het nieuwste GroupDocs.Redaction for .NET pakket via NuGet
  • Direct Download – Download de GroupDocs.Redaction‑assemblies van de GroupDocs.Redaction for .NET 26.6 pagina

Meer informatie