Converter.ConversionEventイベント

変換中に発生するエラー、警告、情報メッセージのイベント

Convert(AnalysisResult, Document, Stream, ConversionOptions, OutputOptions)で発生した変換イベントを報告します。
これらのイベントは、以下の目的で使用できます:

• 詳細な変換レポートを生成
• 重要な変換イベントを検出して処理

Convert(AnalysisResult, Document, Stream, ConversionOptions, OutputOptions)はPDF文書を要求された準拠規格に変換できない場合に例外をスローします。
ただし、出力PDF文書がすべての必須の規格基準を満たしている場合でも変換によっては許容されない場合があります。このような潜在的に生じる重大な変換の問題は変換イベントとして報告されます。

変換プロセスで許容できる変換イベントと、重要と見なす必要がある変換イベントを確認することを推奨します。

• 提案されたイベントの重大度を確認:
  各イベントにはイベントのカテゴリに基づいてデフォルトの重大度が示されています。各EventCategoryの推奨重大度を確認し各々のプロセスで使用するEventSeverityに対する処理を決定してください。
• イベントの重大度に応じてのイベントを処理
  • イベントがEventSeverity.Error: (エラー)
    変換は失敗したとみなす必要があります。
  • イベントがEventSeverity.Warning: (警告)
    出力PDF文書を提示した上でその結果が許容できるかどうかを判断するのが最適です。出力PDF文書と組み合わせた各プロパティのメッセージ、コンテキスト、ページがこの判断に役立ちます。
    手動による判断が難しい場合は重大な警告はエラーとして分類する必要があります。 ただし、処理対象のすべての入力PDF文書の内容が類似している場合などは、代表的なテストファイルを使用して変換結果を検証しそれに応じてイベントの重大度を選択します。
  • イベントがEventSeverity.Information: (情報)
    これ以上の処理の必要はありません。

PdfTools.PdfA.Conversion.Converterクラス

定義

public event EventHandler<ConverterConversionEventEventArgs> ConversionEvent