GroupDocs.Redaction for .NET 26.6 が利用可能になりました。このリリースでは、ストリームやファイルから明示的な形式でドキュメントを開くことが容易になり、System.Drawing に依存しない新しい描画 API が導入され、クロスプラットフォーム互換性が向上しました。

Fixes and enhancements

  • [Enhancement] ストリームまたはファイルパスからドキュメントを開く際にファイルタイプを指定できるようにしました。 (REDACTIONNET-572)
  • [Enhancement] System.Drawing からの移行により、クロスプラットフォーム互換性を強化しました。 (REDACTIONNET-799)

What’s New?

このリリースは、統合をシンプルにし、API をより広いプラットフォームで利用できるようにする 2 つの領域に焦点を当てています。

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）に依存していました。これらの型はすべてのプラットフォームで利用できず、Linux やコンテナ環境でのデプロイが複雑になることがあります。

新しい GroupDocs.Redaction.Options.Drawing 名前空間は、公開 API で使用できる Color、Point、Size、Rectangle、Font、FontStyle 型を提供します。ReplacementOptions、RegionReplacementOptions、ImageAreaRedaction、PageAreaFilter、TextFragment などのクラスに新しいオーバーロードが追加され、これらの型を受け取ります。

System.Drawing を使用した既存コードは引き続きコンパイル・実行可能です。該当メンバーは非推奨としてマークされており、将来の更新で新しい型へ移行することが推奨されます。

Public API changes

Added

  • LoadOptions.FileType プロパティ
  • LoadOptions(FileType fileType) コンストラクタ
  • GroupDocs.Redaction.Options.Drawing における描画型：Color、Point、Size、Rectangle、Font、FontStyle
  • GroupDocs.Redaction.Options.Drawing 型を受け取る新しいオーバーロード

Obsolete

  • 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 を受け取るオーバーロードを使用

Code examples

Open a document with an explicit file type

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

Use GroupDocs.Redaction.Options.Drawing instead of 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();
}

How to get the update

  • NuGet – 最新の GroupDocs.Redaction for .NET パッケージにアップグレードするには NuGet をご利用ください
  • Direct Download – GroupDocs.Redaction for .NET 26.6 ページからアセンブリをダウンロード

Learn more