ビルドとインストールの問題

`dotnet add package Aspose.Words` がパッケージを見つけられません

そのコマンドは商用の Aspose.Words パッケージを指しており、FOSS エディションではありません — FOSS パッケージ ID は Aspose.Words.FOSS です:

dotnet add package Aspose.Words.FOSS

あるいは、git clone を実行してソースを取得し、次にクローンしたフォルダーに cd し、解決策に対して dotnet build を実行してください:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

次に、パッケージ参照ではなく、独自のアプリケーションから Aspose.Words.csproj へのプロジェクト参照を追加してください。

クローン後にプロジェクト参照が解決されません

クローンされた Aspose.Words-FOSS-for-.NET/Aspose.Words/ フォルダー内の Aspose.Words.csproj を参照していること、そしてまずソリューションが正常にビルドされたこと（dotnet build Aspose.Words.sln -c Release）を確認してください。このライブラリは .NET Standard 2.0 を対象としているため、.NET Framework 4.6.2+ または .NET 6/8/10 を対象とする任意の SDK が参照できます。

読み込みの問題

`UnsupportedFileFormatException`（ドキュメントを読み込むとき）

UnsupportedFileFormatException は、ファイル形式が認識されないか、このエディションでサポートされていない場合に読み込み中にスローされます。このエディションの読み込み対応形式は DOCX、DOCM、DOTX、DOTM、Flat OPC、Markdown、プレーンテキストです — input.doc のようなサポートされていないパスを Document コンストラクタに渡すと、ロードされたドキュメントが返される代わりにこの例外が発生します：

using Aspose.Words;

try
{
    Document doc = new Document("input.doc");
}
catch (UnsupportedFileFormatException ex)
{
    Console.WriteLine("Format not supported by this edition: " + ex.Message);
}

UnsupportedFileFormatException を Document コンストラクタの周囲で捕捉することで、例外が生のスタックトレースとして伝搬するのを防ぎ、明確なメッセージを報告できます。

`FileCorruptedException` が有効に見えるファイルで発生する

FileCorruptedException は、ファイルが破損しているように見え、解析できない場合にロード中にスローされます — 例えば、有効な ZIP ベースの OOXML パッケージでない .docx ファイルや、転送中に切り捨てられたファイルなどです。ファイルを元のソースから再取得し、Document でロードする前に正しく開けることを確認してください。

保護されたドキュメントを開く際の `IncorrectPasswordException`

これは、ドキュメントがパスワードで暗号化されており、Document コンストラクタの LoadOptions オーバーロードに提供されたパスワードが欠落しているか誤っている場合にスローされます。ロードする前に LoadOptions.Password を使用して正しいパスワードを指定してください。

保存およびエクスポートの問題

PDF、XPS、または画像形式への `Document.Save()` が失敗します

このエディションにはページレイアウトおよびレンダリングサブシステムが含まれていないため、Document.Save() は PDF、XPS、または画像形式へのエクスポートができません。

代わりに DOCX、DOCM、DOTX、DOTM、Flat OPC、Markdown、またはプレーンテキストとして保存してください — これらがこのエディションが実際に書き出す形式です。商用版 Aspose.Words for .NET PDF、XPS、そして画像出力を追加します。

ページ番号と目次項目は常に 0 を表示します

Aspose.Words FOSS for .NET には完全なフィールド評価エンジンが含まれているため、DATE や DOCPROPERTY といったコンテンツフィールドは正しく更新されます。ページレイアウトに依存するフィールド — ページ番号、NUMPAGES、および TOC エントリ — は、計算された値ではなくプレースホルダー 0 に評価されます。これは、このエディションに通常文書をページ分割するレイアウトエンジンが含まれていないためです。このエディションでの期待される動作であり、バグではありません。

デジタル署名の問題

文書に署名しても効果がありません

DigitalSignatureUtil.Sign() と関連する署名 API は、商用製品との構造的互換性のためにオブジェクトモデルに存在しますが、この FOSS エディションでは新しい署名の作成は機能しません — 呼び出しても署名された出力は生成されません。このエディションは、Document.DigitalSignatures と DigitalSignatureUtil.LoadSignatures() を介して文書に既に付与された署名を検査・検証できますが、署名ワークフローには .NET 用の商用 Aspose.Words が必要です。

フォントの問題

埋め込みフォントが予想より大きくなっています

EmbedTrueTypeFonts が有効な場合、フォントは文書で実際に使用されているグリフだけにサブセット化されず、全ファイルとして埋め込まれるため、フォントを埋め込んだ保存ファイルは商用製品の同等出力よりも大きくなります。このエディションでは回避策はありません — 埋め込みフォントのサブセット化は含まれていません。

トラブルシューティング Aspose.Words FOSS for .NET