C#でPublisherファイルを操作するAPI

Aspose.PUB for .NETを使用すると、.NETアプリケーションでPUBファイルを操作できます。シンプルで明確な構造を持つ.pubファイルの操作をサポートしています。

PUBファイルのメタデータの編集

Aspose.PUBでアクセス可能な.pubファイルのメタデータ###

Microsoft Publisher(.pub)ファイルには、ファイル自体に関するメタデータ情報があります。この API ソリューションを使用して取得できる情報の例があります：

メタデータ	説明
アプリケーション名	ドキュメントの作成に使用されたアプリケーションの名前
タイトル	出版物のタイトル。
著者	出版物を作成した個人または団体の名前。
バージョン	バージョン値
件名	出版物に関連付けられた簡単な説明またはトピック。
キーワード	出版物の内容を説明する関連キーワードまたはタグ。
コメント	出版物に関する追加メモ。
作成日	出版物が最初に作成された日付。
変更日	出版物が最後に編集された日付。
最終著者	ドキュメントを最後に変更した人物の名前。
テンプレート	ドキュメントの作成元となったアプリケーション固有のテンプレート。
文字数	ドキュメント内の文字数の合計を示します。
単語数	ドキュメント内の単語数の合計を示します。
ページ数	ドキュメント内の総ページ数を表示します。

Aspose.PUB for .NETが提供する.pubファイルのメタデータを扱う機能###

メタデータは、タイトル、会社、言語などのドキュメントのプロパティや関連情報を表します。次の例では halloween-flyer.pub を解析し、 DocSummaryInfo クラスと SummaryInfo クラスを使って 8 つのプロパティを更新します。これらの変更はメモリ上の解析済み Document に適用されます。この例では変更した PUB ファイルを保存しません。

これらの例では、DataDir は入力ディレクトリ、OutputDir は出力ディレクトリです。それぞれをご自身のディレクトリに設定し、ストリームの例を実行する前に出力ディレクトリが存在することを確認してください。アプリケーションでコードを使用する際は、Aspose.Pub と System.IO の名前空間をインポートしてください。

// Edit the metadata of a parsed PUB document in memory

// Parse the input Publisher document.
string fileName = Path.Combine(DataDir, "halloween-flyer.pub");
IPubParser parser = PubFactory.CreateParser(fileName);
Document document = parser.Parse();

// Update document metadata. These changes do not save a PUB file.
document.DocumentSummaryInfo.SetCategory("category");
document.DocumentSummaryInfo.SetCompany("company");
document.DocumentSummaryInfo.SetLanguage("language");

document.SummaryInfo.SetComments("comments");
document.SummaryInfo.SetKeywords("keywords");
document.SummaryInfo.SetLastAuthor("last author");
document.SummaryInfo.SetTitle("title");
document.SummaryInfo.SetSubject("subject");

ストリームに出力を書き込む

次の例では、PUB ドキュメントを TIFF に変換し、結果をファイルストリームに書き込みます。変換後に using ブロックがストリームを閉じます。処理の流れは次のとおりです。

1. Path.Combine(DataDir, "halloween-flyer.pub") で入力パスを作成します。
2. PubFactory.CreateParser(fileName) で IPubParser を作成し、parser.Parse() を呼び出して Document オブジェクトを取得します。
3. Path.Combine(OutputDir, "halloween-flyer_out.tiff") で outPath を作成し、File.Create(outPath) で出力ストリームを開きます。ファイルが存在しない場合は作成され、存在する場合は内容が切り詰められます。
4. PubFactory.CreatePubConverter() を呼び出してコンバーターを作成し、ConvertToFormat(doc, outputStream, PubExportFormats.Tiff) を呼び出して TIFF データをストリームに書き込みます。using ブロックが終了すると、ストリームが破棄されます。

同様の方法で、サポートされている PubExportFormats のいずれかを使用して、PUB を別の形式に変換できます。

// Convert a PUB document to TIFF using an output stream

// Parse the input Publisher document.
string fileName = Path.Combine(DataDir, "halloween-flyer.pub");
IPubParser parser = PubFactory.CreateParser(fileName);
Document doc = parser.Parse();

// Write TIFF output to a file stream and close it after conversion.
string outPath = Path.Combine(OutputDir, "halloween-flyer_out.tiff");
using (FileStream outputStream = File.Create(outPath))
{
    PubFactory.CreatePubConverter().ConvertToFormat(doc, outputStream, PubExportFormats.Tiff);
}

すべての.NETコード例とデータファイルについては、 Aspose.PUB-Documentation for C# Github projectを参照してください。

.pubファイルを操作するためのクロスプラットフォームアプリケーションのセットに実装されたAspose.PUBによって提供される機能もご覧ください。