ワード プロセッシング ドキュメントを操作するための .NET API

DocX 入門

DocX をスムーズに使用するには、まず .NET Framework 4.0 と Visual Studio 2010 以降をインストールする必要があります。 

推奨されるインストール方法は、NuGet を使用することです

 Install-Package DocX -Version 1.5.0

.NET API を介して Word 文書を作成および変更する

オープン ソースの DocX API により、ソフトウェア開発者は DOCX ファイル形式で新しい Word ドキュメントを作成できます。このライブラリでは、ユーザーのニーズに応じて既存の Word ドキュメントを変更することもできます。この API は、画像の追加、表とハイパーリンクの挿入、Word 文書内での段落または箇条書きと番号付きリストの追加もサポートしています。

using (DocX document = DocX.Create("fileformat.docx"))
{
  // Add a new Paragraph to the document.
  Paragraph pagagraph = document.InsertParagraph();
  // Append some text.
  pagagraph.Append("File Format Developer Guide").Font("Arial Black");
  // Save the document.
  document.Save();
}

Word ファイルのカスタム ヘッダー/フッターを管理する

DocX API を使用すると、ソフトウェア開発者は Word DOCX ドキュメント内にカスタム ヘッダーとフッターを追加できます。この API は、表と写真、段落、グラフを含むカスタム ヘッダー/フッターの追加をサポートしています。ドキュメントが作成されたら、テーブルでページのヘッダーの画像を定義できます。奇数ページと偶数ページのヘッダーは同じです。ページのフッターの画像やテキストをテーブルに記述することもできます。

//Create a document
using (DocX document = DocX.Create("FileFormat.docx"))
{
  // Add Header 
  document.AddHeaders();
  Header header = document.Headers.Odd;
  // Insert Paragraph in header
  Paragraph paragraph = header.InsertParagraph();
  paragraph.Append("File Format Developer Guide");
  // Add Footer 
  document.AddFooters();
  Footer footer = document.Footers.Odd;
  // Insert Paragraph in header
  Paragraph paragraph1 = footer.InsertParagraph();
  paragraph1.Append("File Format Develoer Guide");
  // Save Document
  document.Save();
}

Word 文書内の画像を操作する

DocX API を使用すると、ソフトウェア開発者は Word DOCX ドキュメント内に埋め込まれた画像をプログラムで操作できます。まず、ワード文書内に画像が必要です。画像を操作するには、最初にドキュメントを開き、画像に適用するカスタム文字列またはその他の変更を記述し、その後ドキュメントを保存する必要があります。

using (DocX document = DocX.Load("FileFormat.docx"))
{
  //Read Image from word
  var image = document.Images[0];
  Bitmap bitmap = new Bitmap(image.GetStream(FileMode.Open, FileAccess.ReadWrite));
  Graphics graphics = Graphics.FromImage(bitmap);
  // Draw the string
  graphics.DrawString
  (
  "Manipulate Images using DocX",
  new System.Drawing.Font("Tahoma", 20),
  Brushes.Blue,
  new PointF(0, 0)
  );
  // Save document
  document.SaveAs("Output.docx");
}

Word 文書のハイパーリンクを管理する

ハイパーリンクはワープロ ドキュメントの非常に便利な部分であり、ユーザーは外部ドキュメントや既存ドキュメントの内部部分、さらには外部の Web サイトや電子メール アドレスにドキュメントから直接アクセスできます。オープン ソースの DocX API は、2 種類のハイパーリンクの両方をサポートしています。ドキュメント内のブックマークを指す internal と、外部 URL を指す external です。

// reating a bookmark
const chapter1 = new Paragraph({
  heading: HeadingLevel.HEADING_1,
  children: [
    new Bookmark({
      id: "anchorForChapter1",
      children: [
        new TextRun("Chapter 1"),
      ],
    }),
  ],
})
//Create an hyperlink 
const link = new InternalHyperlink({
  children: [
    new TextRun({
      text: "See Chapter 1",
      style: "Hyperlink",
    }),
  ],
  anchor: "anchorForChapter1",
})