移行ガイド

C#でMigraDocからIronPDFに移行する方法

更新日:2026年2月1日

MigraDocからIronPDFへの移行は、あなた for .NET PDFワークフローを、手作業による要素ごとの構築を必要とする冗長なプログラムドキュメントモデルから、既存のWeb開発スキルを活用する最新のHTML/CSSベースのアプローチに変えます。このガイドでは、プロ for .NET開発者向けに、MigraDoc独自のドキュメント・オブジェクト・モデルの険しい学習曲線を解消する、包括的な移行パスを段階的に提供します。

なぜMigraDocからIronPDFに移行するのか

MigraDocの課題

MigraDocは、プログラムによるPDF生成には強力ですが、現代の開発ワークフローに影響を与える基本的な制限があります：

HTML サポートなし:MigraDocは HTML を直接サポートしません。 Paragraph、および Table オブジェクトを使用して、要素ごとにドキュメントを手動で構築する必要があります。既存のHTML/CSSデザインを活用することはできません。

2.独自のドキュメントモデル:MigraDocでは、AddCell() などの概念を持つ独自のドキュメントモデルを学習する必要があります。この急な学習曲線は、ウェブ開発の経歴を持つ開発者にとって特に難しいものです。

3.スタイルオプションの制限:MigraDocは強力なドキュメント構造管理機能を提供しますが、そのスタイル機能は最新の Web ツールと比較すると控えめです。 Format.Alignment などのプロパティは、完全な CSS3 と比較して制限されています。

4.冗長なコード:単純なレイアウトを作成する場合でも、数十行のコードが必要になります。ヘッダー付きの基本的な表であれば、15～20行のMigraDocコードが必要です。

JavaScript をサポートしていません:MigraDocは動的なコンテンツをレンダリングしたり、 JavaScriptを実行したりできないため、最新のチャートやインタラクティブな要素のオプションが制限されます。

6.チャートは基本的:MigraDocのチャート機能は、Chart.js や D3 などの最新 for JavaScriptチャートライブラリと比較すると制限されています。

MigraDocとIronPDFの比較

フィーチャー	MigraDoc	IronPDF
コンテンツの定義	プログラム (ドキュメント/セクション/パラグラフ)	HTML/CSS
学習曲線	Steep (プロプライエタリ DOM)	簡単（ウェブスキル）
スタイリング	限定プロパティ	完全なCSS3
JavaScript	なし	Chromiumの完全な実行
表	手動による列/行の定義	HTML `<table>` CSS 付き
チャート	MigraDocの基本チャート	あらゆるJavaScriptチャートライブラリ
画像	マニュアルサイジング/ポジショニング	標準 HTML `<img>`
レスポンシブレイアウト	サポートされていません	フレックスボックス、グリッド
ライセンス	オープンソース（MIT）	商用

2025年、2026年まで.NET 10とC# 14の導入を計画しているチームにとって、IronPDFは開発者が独自のドキュメントモデルを学ぶのではなく、慣れ親しんだHTML/CSSスキルを使用することを可能にする、将来を見据えた基盤を提供します。

マイグレーションの複雑さの評価

機能別の見積もり作業

フィーチャー	移行の複雑さ
シンプルなテキスト	低レベル
表	低レベル
ヘッダー/フッター	低レベル
スタイル	中規模
画像	低レベル
チャート	中規模

パラダイムシフト

このMigraDoc移行における基本的な変化は、プログラムによるドキュメント構築からHTML ファーストのレンダリングへの変化です。

MigraDoc: ドキュメント → AddSection() → AddParagraph() → PdfDocumentRenderer → Save()
IronPDF：   ChromePdfRenderer → RenderHtmlAsPdf(html) → SaveAs()

このパラダイムシフトにより、コードの複雑さが劇的に軽減される一方、CSSによる無制限のスタイリング機能が提供されます。

始める前に

前提条件

.NET環境: .NET Framework 4.6.2+ または.NET Core 3.1+ / .NET 5/6/7/8/9+
NuGetアクセス: NuGetパッケージをインストールする機能
IronPDFライセンス: IronPDFからライセンスキーを取得します。

NuGetパッケージの変更

# RemoveMigraDocpackages
dotnet remove package PdfSharp-MigraDoc
dotnet remove package PdfSharp-MigraDoc-GDI
dotnet remove package PDFsharp.MigraDoc.Standard

# Install IronPDF
dotnet add package IronPdf

# RemoveMigraDocpackages
dotnet remove package PdfSharp-MigraDoc
dotnet remove package PdfSharp-MigraDoc-GDI
dotnet remove package PDFsharp.MigraDoc.Standard

# Install IronPDF
dotnet add package IronPdf

SHELL

ライセンス構成

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

$vbLabelText $csharpLabel

MigraDocの使用方法を確認する

# Find allMigraDocreferences
grep -r "using MigraDoc\|PdfDocumentRenderer\|AddSection\|AddParagraph" --include="*.cs" .
grep -r "AddTable\|AddRow\|AddColumn\|AddCell\|AddImage" --include="*.cs" .

# Find allMigraDocreferences
grep -r "using MigraDoc\|PdfDocumentRenderer\|AddSection\|AddParagraph" --include="*.cs" .
grep -r "AddTable\|AddRow\|AddColumn\|AddCell\|AddImage" --include="*.cs" .

SHELL

完全な API リファレンス

クラスマッピング

MigraDocクラス	IronPDF 同等物
`Document`	`ChromePdfRenderer`
`Section`	HTML `<body>` または `<div>`
`Paragraph`	HTML `<h1>` など
`FormattedText`	HTML `<strong>` など
`Table`	HTML `<table>`
`Row`	HTML `<tr>`
`Column`	HTML `<col>` または CSS
`Cell`	HTML `<th>`
`PdfDocumentRenderer`	`ChromePdfRenderer`

メソッドマッピング

MigraDocメソッド	IronPDF 同等物
`document.AddSection()`	HTML構造
`section.AddParagraph(text)`	`<p>text</p>`
`section.AddTable()`	`<table>`
`table.AddColumn(width)`	CSS `width` プロパティ
`table.AddRow()`	`<tr>`
`row.Cells[n].AddParagraph()`	`<td>content</td>`
`renderer.RenderDocument()`	`RenderHtmlAsPdf(html)`
`pdfDocument.Save(path)`	`pdf.SaveAs(path)`

プレースホルダーのマッピング(ヘッダー/フッター)

MigraDocメソッド	IronPDF プレースホルダー
`AddPageField()`	`{page}`
`AddNumPagesField()`	`{total-pages}`
`AddDateField()`	`{date}`

コード移行の例

例1: 基本的なHTMLからPDFへ(基本的な違い)

翻訳前 (MigraDoc):

// NuGet: Install-Package PdfSharp-MigraDoc-GDI
using MigraDoc.DocumentObjectModel;
using MigraDoc.Rendering;
using System.Diagnostics;

class Program
{
    static void Main()
    {
        //MigraDocdoesn't support HTML directly
        // Must manually create document structure
        Document document = new Document();
        Section section = document.AddSection();

        Paragraph paragraph = section.AddParagraph();
        paragraph.AddFormattedText("Hello World", TextFormat.Bold);
        paragraph.Format.Font.Size = 16;

        PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();
        pdfRenderer.Document = document;
        pdfRenderer.RenderDocument();
        pdfRenderer.PdfDocument.Save("output.pdf");
    }
}

// NuGet: Install-Package PdfSharp-MigraDoc-GDI
using MigraDoc.DocumentObjectModel;
using MigraDoc.Rendering;
using System.Diagnostics;

class Program
{
    static void Main()
    {
        //MigraDocdoesn't support HTML directly
        // Must manually create document structure
        Document document = new Document();
        Section section = document.AddSection();

        Paragraph paragraph = section.AddParagraph();
        paragraph.AddFormattedText("Hello World", TextFormat.Bold);
        paragraph.Format.Font.Size = 16;

        PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();
        pdfRenderer.Document = document;
        pdfRenderer.RenderDocument();
        pdfRenderer.PdfDocument.Save("output.pdf");
    }
}

Imports MigraDoc.DocumentObjectModel
Imports MigraDoc.Rendering
Imports System.Diagnostics

Class Program
    Shared Sub Main()
        ' MigraDoc doesn't support HTML directly
        ' Must manually create document structure
        Dim document As New Document()
        Dim section As Section = document.AddSection()

        Dim paragraph As Paragraph = section.AddParagraph()
        paragraph.AddFormattedText("Hello World", TextFormat.Bold)
        paragraph.Format.Font.Size = 16

        Dim pdfRenderer As New PdfDocumentRenderer()
        pdfRenderer.Document = document
        pdfRenderer.RenderDocument()
        pdfRenderer.PdfDocument.Save("output.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

この例はMigraDocとIronPDFの基本的な違いを示しています。MigraDocでは、Document を作成し、Section を追加し、Paragraph を追加し、AddFormattedText() を TextFormat.Bold と共に使用し、Format.Font.Size を設定し、PdfDocumentRenderer を作成し、ドキュメントを割り当て、RenderDocument() を呼び出し、最後に保存する必要があります。複数のオブジェクトを含む10行以上のコードです。

IronPdfは3行で同じ結果を達成します: レンダラーを作成し、HTMLをレンダリングし、保存します。 HTML の <h1> タグは、自然に太字の大きな見出しスタイルを提供します。その他のレンダリングオプションについては、HTML to PDF documentationを参照してください。

例 2: テーブルの作成

翻訳前 (MigraDoc):

// NuGet: Install-Package PdfSharp-MigraDoc-GDI
using MigraDoc.DocumentObjectModel;
using MigraDoc.DocumentObjectModel.Tables;
using MigraDoc.Rendering;

class Program
{
    static void Main()
    {
        Document document = new Document();
        Section section = document.AddSection();

        Table table = section.AddTable();
        table.Borders.Width = 0.75;

        Column column1 = table.AddColumn("3cm");
        Column column2 = table.AddColumn("3cm");

        Row row1 = table.AddRow();
        row1.Cells[0].AddParagraph("Name");
        row1.Cells[1].AddParagraph("Age");

        Row row2 = table.AddRow();
        row2.Cells[0].AddParagraph("John");
        row2.Cells[1].AddParagraph("30");

        PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();
        pdfRenderer.Document = document;
        pdfRenderer.RenderDocument();
        pdfRenderer.PdfDocument.Save("table.pdf");
    }
}

// NuGet: Install-Package PdfSharp-MigraDoc-GDI
using MigraDoc.DocumentObjectModel;
using MigraDoc.DocumentObjectModel.Tables;
using MigraDoc.Rendering;

class Program
{
    static void Main()
    {
        Document document = new Document();
        Section section = document.AddSection();

        Table table = section.AddTable();
        table.Borders.Width = 0.75;

        Column column1 = table.AddColumn("3cm");
        Column column2 = table.AddColumn("3cm");

        Row row1 = table.AddRow();
        row1.Cells[0].AddParagraph("Name");
        row1.Cells[1].AddParagraph("Age");

        Row row2 = table.AddRow();
        row2.Cells[0].AddParagraph("John");
        row2.Cells[1].AddParagraph("30");

        PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();
        pdfRenderer.Document = document;
        pdfRenderer.RenderDocument();
        pdfRenderer.PdfDocument.Save("table.pdf");
    }
}

Imports MigraDoc.DocumentObjectModel
Imports MigraDoc.DocumentObjectModel.Tables
Imports MigraDoc.Rendering

Class Program
    Shared Sub Main()
        Dim document As New Document()
        Dim section As Section = document.AddSection()

        Dim table As Table = section.AddTable()
        table.Borders.Width = 0.75

        Dim column1 As Column = table.AddColumn("3cm")
        Dim column2 As Column = table.AddColumn("3cm")

        Dim row1 As Row = table.AddRow()
        row1.Cells(0).AddParagraph("Name")
        row1.Cells(1).AddParagraph("Age")

        Dim row2 As Row = table.AddRow()
        row2.Cells(0).AddParagraph("John")
        row2.Cells(1).AddParagraph("30")

        Dim pdfRenderer As New PdfDocumentRenderer()
        pdfRenderer.Document = document
        pdfRenderer.RenderDocument()
        pdfRenderer.PdfDocument.Save("table.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlTable = @"
            <table border='1'>
                <tr><th>Name</th><th>Age</th></tr>
                <tr><td>John</td><td>30</td></tr>
            </table>";

        var pdf = renderer.RenderHtmlAsPdf(htmlTable);
        pdf.SaveAs("table.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlTable = @"
            <table border='1'>
                <tr><th>Name</th><th>Age</th></tr>
                <tr><td>John</td><td>30</td></tr>
            </table>";

        var pdf = renderer.RenderHtmlAsPdf(htmlTable);
        pdf.SaveAs("table.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim htmlTable As String = "
            <table border='1'>
                <tr><th>Name</th><th>Age</th></tr>
                <tr><td>John</td><td>30</td></tr>
            </table>"

        Dim pdf = renderer.RenderHtmlAsPdf(htmlTable)
        pdf.SaveAs("table.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

MigraDoc テーブルの作成には、Row、および Cell 階層を理解する必要があります。 AddColumn() を使用して列を明示的に追加し、AddRow() を使用して行を作成し、Cells[n] を使用してインデックスによってセルにアクセスし、AddParagraph() を使用してコンテンツを追加する必要があります。境界はtable.Borders.Widthによって設定されます。

IronPdfはウェブ開発者なら誰でも知っている標準的なHTMLテーブル構文を使用しています。 border='1' 属性は境界線を提供し、<th> 要素はヘッダーセルを作成し、<td> 要素はデータセルを作成します。ゼブラストライプ、ホバー効果、レスポンシブレイアウトなどの高度なスタイリングのためにCSSを追加することができます。 PDFに表を作成するについて、さらに詳しく学んでください。

例3：ページ番号を含むヘッダーとフッター

翻訳前 (MigraDoc):

// NuGet: Install-Package PdfSharp-MigraDoc-GDI
using MigraDoc.DocumentObjectModel;
using MigraDoc.Rendering;

class Program
{
    static void Main()
    {
        Document document = new Document();
        Section section = document.AddSection();

        // Add header
        Paragraph headerPara = section.Headers.Primary.AddParagraph();
        headerPara.AddText("Document Header");
        headerPara.Format.Font.Size = 12;
        headerPara.Format.Alignment = ParagraphAlignment.Center;

        // Add footer
        Paragraph footerPara = section.Footers.Primary.AddParagraph();
        footerPara.AddText("Page ");
        footerPara.AddPageField();
        footerPara.Format.Alignment = ParagraphAlignment.Center;

        // Add content
        section.AddParagraph("Main content of the document");

        PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();
        pdfRenderer.Document = document;
        pdfRenderer.RenderDocument();
        pdfRenderer.PdfDocument.Save("header-footer.pdf");
    }
}

// NuGet: Install-Package PdfSharp-MigraDoc-GDI
using MigraDoc.DocumentObjectModel;
using MigraDoc.Rendering;

class Program
{
    static void Main()
    {
        Document document = new Document();
        Section section = document.AddSection();

        // Add header
        Paragraph headerPara = section.Headers.Primary.AddParagraph();
        headerPara.AddText("Document Header");
        headerPara.Format.Font.Size = 12;
        headerPara.Format.Alignment = ParagraphAlignment.Center;

        // Add footer
        Paragraph footerPara = section.Footers.Primary.AddParagraph();
        footerPara.AddText("Page ");
        footerPara.AddPageField();
        footerPara.Format.Alignment = ParagraphAlignment.Center;

        // Add content
        section.AddParagraph("Main content of the document");

        PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();
        pdfRenderer.Document = document;
        pdfRenderer.RenderDocument();
        pdfRenderer.PdfDocument.Save("header-footer.pdf");
    }
}

Imports MigraDoc.DocumentObjectModel
Imports MigraDoc.Rendering

Class Program
    Shared Sub Main()
        Dim document As New Document()
        Dim section As Section = document.AddSection()

        ' Add header
        Dim headerPara As Paragraph = section.Headers.Primary.AddParagraph()
        headerPara.AddText("Document Header")
        headerPara.Format.Font.Size = 12
        headerPara.Format.Alignment = ParagraphAlignment.Center

        ' Add footer
        Dim footerPara As Paragraph = section.Footers.Primary.AddParagraph()
        footerPara.AddText("Page ")
        footerPara.AddPageField()
        footerPara.Format.Alignment = ParagraphAlignment.Center

        ' Add content
        section.AddParagraph("Main content of the document")

        Dim pdfRenderer As New PdfDocumentRenderer()
        pdfRenderer.Document = document
        pdfRenderer.RenderDocument()
        pdfRenderer.PdfDocument.Save("header-footer.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Main content of the document</h1>");

        pdf.AddTextHeader("Document Header");
        pdf.AddTextFooter("Page {page}");

        pdf.SaveAs("header-footer.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Main content of the document</h1>");

        pdf.AddTextHeader("Document Header");
        pdf.AddTextFooter("Page {page}");

        pdf.SaveAs("header-footer.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Main content of the document</h1>")

        pdf.AddTextHeader("Document Header")
        pdf.AddTextFooter("Page {page}")

        pdf.SaveAs("header-footer.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

MigraDoc のヘッダーとフッターでは、section.Headers.Primary と section.Footers.Primary にアクセスし、それら内に段落を作成し、AddText() を使用してテキストを追加し、動的コンテンツには AddPageField() などの特殊なメソッドを使用する必要があります。アライメントには Format.Alignment の設定が必要です。

IronPDF は、PdfDocument オブジェクトに対してシンプルな AddTextHeader() および AddTextFooter() メソッドを提供します。 {page} プレースホルダーは、現在のページ番号を自動的に挿入します。より複雑なヘッダーの場合は、完全なHTML/CSSサポートを備えた HtmlHeaderFooter を使用できます。高度なオプションについては、headers and footers documentationを参照してください。

重要な移行に関する注意事項

ページ番号プレースホルダーの構文

ヘッダーとフッターの最も重要な変更点は、プレースホルダーの構文です：

//MigraDocfield methods:
footerPara.AddPageField();       // Current page
footerPara.AddNumPagesField();   // Total pages

//IronPDFplaceholders:
"Page {page} of {total-pages}"

//MigraDocfield methods:
footerPara.AddPageField();       // Current page
footerPara.AddNumPagesField();   // Total pages

//IronPDFplaceholders:
"Page {page} of {total-pages}"

' MigraDoc field methods:
footerPara.AddPageField()       ' Current page
footerPara.AddNumPagesField()   ' Total pages

' IronPDF placeholders:
"Page {page} of {total-pages}"

$vbLabelText $csharpLabel

フォーマットプロパティを CSS に

MigraDoc の Format プロパティは CSS にマップされます:

// MigraDoc:
paragraph.Format.Font.Size = 16;
paragraph.Format.Font.Bold = true;
paragraph.Format.Alignment = ParagraphAlignment.Center;

//IronPDF(CSS):
<p style="font-size: 16pt; font-weight: bold; text-align: center;">

// MigraDoc:
paragraph.Format.Font.Size = 16;
paragraph.Format.Font.Bold = true;
paragraph.Format.Alignment = ParagraphAlignment.Center;

//IronPDF(CSS):
<p style="font-size: 16pt; font-weight: bold; text-align: center;">

' MigraDoc:
paragraph.Format.Font.Size = 16
paragraph.Format.Font.Bold = True
paragraph.Format.Alignment = ParagraphAlignment.Center

' IronPDF(CSS):
'<p style="font-size: 16pt; font-weight: bold; text-align: center;">

$vbLabelText $csharpLabel

ユニット変換

MigraDocはさまざまな単位を使用します； IronPDFのマージンにはミリメートルを使用しています：

"1cm = 10mm
"1in" = 25.4mm
"72pt" = 25.4mm

// MigraDoc:
table.AddColumn("3cm");

//IronPDF(CSS):
<th style="width: 3cm;">

// MigraDoc:
table.AddColumn("3cm");

//IronPDF(CSS):
<th style="width: 3cm;">

' MigraDoc:
table.AddColumn("3cm")

' IronPDF(CSS):
<th style="width: 3cm;">

$vbLabelText $csharpLabel

レンダリングパターンの変更

レンダリングパターン全体が変わります：

//MigraDocpattern (DELETE):
PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();
pdfRenderer.Document = document;
pdfRenderer.RenderDocument();
pdfRenderer.PdfDocument.Save("output.pdf");

//IronPDFpattern:
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

//MigraDocpattern (DELETE):
PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();
pdfRenderer.Document = document;
pdfRenderer.RenderDocument();
pdfRenderer.PdfDocument.Save("output.pdf");

//IronPDFpattern:
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

' MigraDocpattern (DELETE):
Dim pdfRenderer As New PdfDocumentRenderer()
pdfRenderer.Document = document
pdfRenderer.RenderDocument()
pdfRenderer.PdfDocument.Save("output.pdf")

' IronPDFpattern:
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

トラブルシューティング

問題1: ドキュメント/セクションが見つかりません

問題: Document および Section クラスがIronPDFに存在しません。

解決策: HTML 構造に置き換えます:

// MigraDoc
Document document = new Document();
Section section = document.AddSection();

// IronPDF
string html = "<html><body>...</body></html>";
var pdf = renderer.RenderHtmlAsPdf(html);

// MigraDoc
Document document = new Document();
Section section = document.AddSection();

// IronPDF
string html = "<html><body>...</body></html>";
var pdf = renderer.RenderHtmlAsPdf(html);

Imports MigraDoc.DocumentObjectModel
Imports IronPdf

Dim document As New Document()
Dim section As Section = document.AddSection()

Dim html As String = "<html><body>...</body></html>"
Dim pdf = renderer.RenderHtmlAsPdf(html)

$vbLabelText $csharpLabel

課題2：AddParagraphが見つかりません

問題: AddParagraph() メソッドが存在しません。

解決策: HTML 要素を使用する:

// MigraDoc
section.AddParagraph("Hello World");

// IronPDF
"<p>Hello World</p>"

// MigraDoc
section.AddParagraph("Hello World");

// IronPDF
"<p>Hello World</p>"

$vbLabelText $csharpLabel

問題 3: PdfDocumentRenderer が見つかりません

問題: PdfDocumentRenderer クラスが存在しません。

解決策: ChromePdfRenderer を使用します。

// MigraDoc
PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();

// IronPDF
var renderer = new ChromePdfRenderer();

// MigraDoc
PdfDocumentRenderer pdfRenderer = new PdfDocumentRenderer();

// IronPDF
var renderer = new ChromePdfRenderer();

' MigraDoc
Dim pdfRenderer As New PdfDocumentRenderer()

' IronPDF
Dim renderer As New ChromePdfRenderer()

$vbLabelText $csharpLabel

問題 4: AddPageField が動作しない

問題: AddPageField() メソッドが存在しません。

解決策: IronPDFプレースホルダー構文を使用します。

// MigraDoc
footerPara.AddPageField();

// IronPDF
pdf.AddTextFooter("Page {page}");

// MigraDoc
footerPara.AddPageField();

// IronPDF
pdf.AddTextFooter("Page {page}");

' MigraDoc
footerPara.AddPageField()

' IronPDF
pdf.AddTextFooter("Page {page}")

$vbLabelText $csharpLabel

移行チェックリスト

移行前

すべてのMigraDocusing ステートメントを識別します
ドキュメントの表構造(列、行、スタイル)
ヘッダー/フッターの内容とページフィールドの使用法をメモする
document.Styles で定義されたカスタムスタイルを一覧表示します
IronPDFライセンスキーを取得する

パッケージの変更

PdfSharp-MigraDoc パッケージを削除します
PdfSharp-MigraDoc-GDI パッケージを削除します
IronPdf NuGetパッケージをインストールします: dotnet add package IronPdf
名前空間のインポートを更新する

コードの変更

起動時にライセンスキー設定を追加する
Section を HTML 構造に置き換えます
AddParagraph() を HTML <p> 要素に変換します
Cell を HTML <table> 構造に変換します
AddPageField() を {page} プレースホルダーに置き換えます
AddNumPagesField() を {total-pages} プレースホルダーに置き換えます
Format プロパティを CSS スタイルに変換する
PdfDocumentRenderer を ChromePdfRenderer に置き換えます

テスティング

古いPDFと新しいPDFの視覚的な出力を比較する
ページ区切りが正しく機能していることを確認する
ヘッダー/フッターのレンダリングとページ番号を確認する
表の書式と境界線を検証する
複雑な複数ページのドキュメントでテストする

移行後

MigraDoc関連のドキュメントを削除する
チームのトレーニング資料を更新する
新しい HTML テンプレートの場所を文書化する

カーティス・チャウ

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

30日間無料トライアルを開始

C#でMigraDocからIronPDFに移行する方法

なぜMigraDocからIronPDFに移行するのか

MigraDocの課題

MigraDocとIronPDFの比較

マイグレーションの複雑さの評価

機能別の見積もり作業

パラダイムシフト

始める前に

前提条件

NuGetパッケージの変更

ライセンス構成

MigraDocの使用方法を確認する

完全な API リファレンス

クラスマッピング

メソッドマッピング

プレースホルダーのマッピング(ヘッダー/フッター)

コード移行の例

例1: 基本的なHTMLからPDFへ(基本的な違い)

例 2: テーブルの作成

例3：ページ番号を含むヘッダーとフッター

重要な移行に関する注意事項

ページ番号プレースホルダーの構文

フォーマット プロパティを CSS に

ユニット変換

レンダリング パターンの変更

トラブルシューティング

問題1: ドキュメント/セクションが見つかりません

課題2：AddParagraphが見つかりません

問題 3: PdfDocumentRenderer が見つかりません

問題 4: AddPageField が動作しない

移行チェックリスト

移行前

パッケージの変更

コードの変更

テスティング

移行後

関連する記事

C#でZetPDFからIronPDFに移行する方法

C#でScryber.CoreからIronPDFに移行する方法

C#でXFINIUM.PDFからIronPDFへ移行する方法

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

世界中の数百万人のエンジニアから信頼されています。

アイアンサポートチーム

フォーマットプロパティを CSS に

レンダリングパターンの変更