GroupDocs.Redaction for .NET 26.9 è ora disponibile. Questa versione rimuove la dipendenza System.Drawing.Common dai pacchetti .NET 6, .NET 8 e .NET 10 e migliora la compatibilità multipiattaforma con Linux e altri sistemi operativi supportati.

Correzioni e miglioramenti

  • [Enhancement] Migrazione da System.Drawing per migliorare la compatibilità multipiattaforma. (REDACTIONNET-799)

Novità

La versione 26.9 completa la migrazione da System.Drawing. I tipi System.Drawing sono stati rimossi dall’API pubblica. Il codice interno continua a utilizzare System.Drawing per l’elaborazione dei documenti solo su .NET Framework 4.6.2.

Pacchetti multipiattaforma senza System.Drawing.Common

I pacchetti .NET 6, .NET 8 e .NET 10 non dipendono più da System.Drawing.Common. L’elaborazione dei documenti non richiede GDI+ o libgdiplus. La build per .NET Framework 4.6.2 utilizza ancora lo stack Windows GDI+.

Tipi System.Drawing rimossi dall’API pubblica

I valori di colore, punto, dimensione, rettangolo e font provengono ora esclusivamente da GroupDocs.Redaction.Options.Drawing. Il codice che ancora passa System.Drawing.Color, System.Drawing.Point, System.Drawing.Size, System.Drawing.Rectangle o System.Drawing.Font non compila più.

GroupDocs.Redaction.Options.Drawing.Color espone ancora i colori denominati come Color.Black e Color.Blue, oltre a Color.FromName e Color.FromArgb.

I nomi dei membri originali sono nuovamente l’API corrente. BoxColor, FillColor, Size, TopLeft e Rectangle ora utilizzano i tipi di disegno di GroupDocs. Gli alias temporanei aggiunti nella 26.6 sono obsoleti:

Alias obsoleto Da usare invece
ReplacementOptions.BoxFillColor ReplacementOptions.BoxColor
RegionReplacementOptions.AreaFillColor RegionReplacementOptions.FillColor
RegionReplacementOptions.AreaSize RegionReplacementOptions.Size
ImageAreaRedaction.TopLeftPosition ImageAreaRedaction.TopLeft
PageAreaFilter.AreaRectangle PageAreaFilter.Rectangle
TextFragment.BoundingRectangle TextFragment.Rectangle

Modifiche all’API pubblica

Rimosse

  • Membri pubblici che accettavano o restituivano tipi System.Drawing su ReplacementOptions, RegionReplacementOptions, ImageAreaRedaction, PageAreaFilter, TextFragment e IImageFormatInstance
  • ReplacementOptions(System.Drawing.Color)
  • Costruttori di RegionReplacementOptions che prendevano System.Drawing.Color, System.Drawing.Size o 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 corrente

  • ReplacementOptions.BoxColor e ReplacementOptions(GroupDocs.Redaction.Options.Drawing.Color)
  • RegionReplacementOptions.FillColor, RegionReplacementOptions.Size e costruttori che accettano colore, dimensione e font da GroupDocs.Redaction.Options.Drawing
  • ImageAreaRedaction.TopLeft e ImageAreaRedaction(GroupDocs.Redaction.Options.Drawing.Point, RegionReplacementOptions)
  • PageAreaFilter.Rectangle e PageAreaFilter(GroupDocs.Redaction.Options.Drawing.Point, GroupDocs.Redaction.Options.Drawing.Size)
  • TextFragment.Rectangle e TextFragment(string, GroupDocs.Redaction.Options.Drawing.Rectangle)
  • IImageFormatInstance.EditArea(GroupDocs.Redaction.Options.Drawing.Point, RegionReplacementOptions)

Obsoleti

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

Esempi di codice

Disegnare un riquadro colorato sopra il testo corrispondente

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

Redigere un’area di un’immagine

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

Come ottenere l’aggiornamento

  • NuGet – Aggiorna al pacchetto più recente GroupDocs.Redaction for .NET tramite NuGet
  • Download diretto – Scarica gli assembly di GroupDocs.Redaction dalla pagina GroupDocs.Redaction for .NET 26.9

Per saperne di più