トラブルシューティング

Aspose.PDF FOSS for .NET を使用する際の一般的な問題と解決策

問題	原因	解決策
`Document.Open` が有効な PDF で例外をスローする	ファイルがパスワードで保護されている	コンストラクタでパスワードを指定する
大きな PDF でメモリ不足になる	ファイル全体がバイト配列に読み込まれる	ページを個別に処理するか、ストリーミングを使用する
`Pages[0]` がインデックスエラーをスローする	ページが 1 ベースのインデックスを使用している	最初のページには `Pages[1]` を使用する

Problem	Cause	Solution
保存後に注釈が表示されない	矩形の面積がゼロ、またはページ境界外にある	座標がページ内に収まっていることを確認してください `MediaBox`
`LinkAnnotation.Uri` が null を返す	リンクが GoTo または JavaScript アクションを使用している	`PdfAction.Create` で解決し、`ActionType` を確認してください
`Flatten()` がスローされる	注釈に `/P`（ページ）参照が欠如している	注釈が `Page.Annotations` を通じて追加されたことを確認してください

問題	原因	解決策
抽出されたテキストが文字化けしている	非標準エンコーディングまたはCIDフォントマッピング	フォント埋め込みを確認してください；スキャンされたPDFはOCRが必要な場合があります
テキストフラグメントが見つからない	ページ内容がラスタ画像です	テキスト抽出の前にOCRを使用してください
正規表現が一致しない	PDFテキストレイアウトが空白を挿入します	より緩やかなパターンを使用するか、空白を正規化してください

Problem	Cause	Solution
レンダリングされた画像がぼやけている	解像度が低すぎる	`Resolution` コンストラクタで DPI を増やす
HTML 出力で画像が欠落している	外部画像パスが設定されていない	`HtmlSaveOptions` を埋め込み画像で使用する
PDF/A 変換で注釈が削除される	対象プロファイルが注釈を許可していない	PDF/A-2 または PDF/A-3 を使用する

問題	原因	解決策
フィールド値が空です	フィールドに`/V`エントリがありません	`field.Value`がnullでないことを確認してください
`FillField`は効果がありません	フィールド名が一致しません	利用可能な名前を一覧表示するには`Form.FieldNames`を使用してください
ExportToJsonが空の出力を生成します	ウィジェット注釈が正しくキャストされていません	注釈が`WidgetAnnotation`であることを確認してください

トラブルシューティング

参照