フッターコンテンツにスキップ
移行ガイド

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

TallComponentsからIronPDFへの移行:完全なC#開発者ガイド

ApryseがTallComponentsを買収したとき、.NET PDFの状況は大きく変わりました。 TallComponentsの新規ライセンスが終了し、既存ユーザーはiText SDKにリダイレクトされるため、TallPDFとPDFKitを使用している開発者は避けられない決断を迫られています。

このガイドでは、TallComponentsからIronPDFへの完全な移行パスを提供します。ステップバイステップの手順、APIマッピング、実際のコード例を含み、.NET開発者が効率的に移行できるように支援します。

なぜTallComponentsへの移行が必須なのか

TallComponents は、かつて C# PDF 生成の有名企業でした。 ライブラリは、XMLベースのドキュメントワークフローとプログラムによるPDF操作を提供しました。 しかし、Apryseによる買収によって新規ライセンス販売が終了し、開発チームにとっての計算が根本的に変わりました。

TallComponentsの重要な制限事項

TallComponentsは、技術的に大きな負債を抱えています:

製品廃止: Apryseの買収以来、新しいライセンスはありません。トールコンポーネントの公式ウェブサイトでは、新規ライセンスの販売が終了したことを明示し、代わりに iText SDK を採用するよう潜在的なユーザーに案内しています。

HTMLからPDFへのサポートはありません:最新のPDFライブラリとは異なり、TallComponentsはHTMLからPDFへの直接変換をサポートしていません。 サポートプラットフォームの開発者は、この限界を確認しており、Pechkinのようなサードパーティのソリューションを選択肢として指摘しています。

文書化されたレンダリングのバグ:変更履歴には、空白ページのレンダリング、グラフィックスの欠落、信頼性の低い JPEG 画像の処理、不正なフォント表示など、広範なレンダリングの問題が記載されています。 これらのバグは、廃止前に解決されることはありませんでした。

サポートやアップデートはありません:積極的なメンテナンスがない場合、.NET 10およびC# 14のセキュリティ脆弱性や互換性の問題は対処されないままとなります。

IronPDF:最新のTallComponents代替ツール

IronPDFは、TallComponentsを現代の開発ワークフローで問題にしていた核となる制限に対処しています:

フィーチャートールコンポーネントIronPDF
現在の販売状況新規販売終了積極的な開発と販売
HTMLからPDFへのサポートなしはい(Chromiumを使用したHTML5/CSS3)
レンダリングの忠実度既知のバグと問題実証済みの信頼性
インストール複雑、マニュアルNuGetでシンプルに
カスタマーサポートiText SDK への移行積極的なサポートとコミュニティ
将来のユーザビリティ使用終了長期的な有効性

TallComponentsは.NET開発の異なる時代からXMLベースのアプローチを提供し、IronPDFは今日の開発者がアプリケーションを構築する方法に沿ったChromiumパワーのHTMLレンダリングを提供します。

クイックスタート:TallComponentsからIronPDFへの移行

ステップ 1: NuGet パッケージを置き換える。

プロジェクトからすべてのTallComponentsパッケージを削除してください:

# Removeトールコンポーネントpackages
dotnet remove package TallComponents.PDF.Kit
dotnet remove package TallComponents.PDF.Layout
dotnet remove package TallComponents.PDF.Layout.Drawing
# Removeトールコンポーネントpackages
dotnet remove package TallComponents.PDF.Kit
dotnet remove package TallComponents.PDF.Layout
dotnet remove package TallComponents.PDF.Layout.Drawing
SHELL

IronPDFをインストールします:

# Install IronPDF
dotnet add package IronPdf
# Install IronPDF
dotnet add package IronPdf
SHELL

特殊なフレームワークのために、IronPdfは専用の拡張パッケージを提供しています:

Blazorサーバー:

PM > Install-Package IronPdf.Extensions.Blazor
PM > Install-Package IronPdf.Extensions.Blazor
SHELL

MAUI:

PM > Install-Package IronPdf.Extensions.Maui
PM > Install-Package IronPdf.Extensions.Maui
SHELL

MVCフレームワーク:

PM > Install-Package IronPdf.Extensions.Mvc.Framework
PM > Install-Package IronPdf.Extensions.Mvc.Framework
SHELL

ステップ 2: 名前空間の更新

TallComponents名前空間をIronPdf名前空間に置き換えてください:

// Before (TallComponents)
using TallComponents.PDF.Kit;
using TallComponents.PDF.Layout;
using TallComponents.PDF.Layout.Drawing;
using TallComponents.PDF.Layout.Paragraphs;

// After (IronPDF)
using IronPdf;
// Before (TallComponents)
using TallComponents.PDF.Kit;
using TallComponents.PDF.Layout;
using TallComponents.PDF.Layout.Drawing;
using TallComponents.PDF.Layout.Paragraphs;

// After (IronPDF)
using IronPdf;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

ステップ 3: ライセンスの初期化

アプリケーション起動時のライセンス初期化を追加します:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
$vbLabelText   $csharpLabel

TallComponentsからIronPDFへのAPIマッピングリファレンス

TallComponentsのコンセプトがIronPDFにどのようにマッピングされるかを理解することで、移行プロセスが加速されます:

トールコンポーネントIronPDFノート
<コード>ドキュメント</コード<コード>ChromePdfRenderer</コードPDF生成のためのレンダラー作成
<コード>セクション</コード自動翻訳HTML構造から派生したセクション
<コード>テキストパラグラフ</コードHTMLテキスト要素<p><h1><div>などを使用してください。
<コード>イメージパラグラフ</コード<img>タグ標準的なHTML画像
<コード>表段落</コードHTML <コード><テーブル><コード></コード標準的なHTMLテーブル
<コード>フォント</コードCSS <コード>font-family</コードウェブフォント完全対応
<コード>document.Write()</コード<コード>pdf.SaveAs()</コードファイルに保存
<コード>document.Write(stream)<コード></コードpdf.BinaryDataまたは pdf.Streamストリーム出力
<コード>Page.Canvas</コードHTML/CSSレンダリング手作業によるキャンバス操作は不要
XmlDocument.Generate()を使用してください。<コード>RenderHtmlAsPdf()</コードHTMLがXMLに代わる
PdfKit.Merger.Merge().PdfDocument.Merge()を使用してください。複数のPDFをマージ
ドキュメント.セキュリティ<コード>pdf.SecuritySettings</コードPDFセキュリティ設定
<コード>ページレイアウト</コード<コード>レンダリングオプション</コードページ設定と余白

コード移行の例

HTML を PDF に変換する

TallComponentsは、ネイティブのHTMLからPDFへのサポートを欠いています。 回避策は、テキストからフラグメントを作成することで、実際にはHTMLをレンダリングしません:

TallComponentsのアプローチ:

// NuGet: Install-Package TallComponents.PDF.Kit
using TallComponents.PDF.Kit;
using System.IO;

class Program
{
    static void Main()
    {
        // Create a new document
        using (Document document = new Document())
        {
            string html = "<html><body><h1>Hello World</h1><p>This is a PDF from HTML.</p></body></html>";

            // Create HTML fragment
            Fragment fragment = Fragment.FromText(html);

            // Add to document
            Section section = document.Sections.Add();
            section.Fragments.Add(fragment);

            // Save to file
            using (FileStream fs = new FileStream("output.pdf", FileMode.Create))
            {
                document.Write(fs);
            }
        }
    }
}
// NuGet: Install-Package TallComponents.PDF.Kit
using TallComponents.PDF.Kit;
using System.IO;

class Program
{
    static void Main()
    {
        // Create a new document
        using (Document document = new Document())
        {
            string html = "<html><body><h1>Hello World</h1><p>This is a PDF from HTML.</p></body></html>";

            // Create HTML fragment
            Fragment fragment = Fragment.FromText(html);

            // Add to document
            Section section = document.Sections.Add();
            section.Fragments.Add(fragment);

            // Save to file
            using (FileStream fs = new FileStream("output.pdf", FileMode.Create))
            {
                document.Write(fs);
            }
        }
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPDFのアプローチ:

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        // Create a PDF from HTML string
        var renderer = new ChromePdfRenderer();
        string html = "<html><body><h1>Hello World</h1><p>This is a PDF from HTML.</p></body></html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        // Create a PDF from HTML string
        var renderer = new ChromePdfRenderer();
        string html = "<html><body><h1>Hello World</h1><p>This is a PDF from HTML.</p></body></html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPDFのChromePdfRendererは本物のChromiumエンジンを使用しており、HTML5とCSS3を完全にサポートしています。 これは、PDFが最新のブラウザで表示されるように正確にレンダリングされることを意味します。 詳しくはHTML to PDFチュートリアルをご覧ください。

複数のPDFをマージする

PDFマージはTallComponentsとIronPDFの冗長性の違いを示しています。

TallComponentsのアプローチ:

// NuGet: Install-Package TallComponents.PDF.Kit
using TallComponents.PDF.Kit;
using System.IO;

class Program
{
    static void Main()
    {
        // Create output document
        using (Document outputDoc = new Document())
        {
            // Load first PDF
            using (FileStream fs1 = new FileStream("document1.pdf", FileMode.Open))
            using (Document doc1 = new Document(fs1))
            {
                foreach (Page page in doc1.Pages)
                {
                    outputDoc.Pages.Add(page.Clone());
                }
            }

            // Load second PDF
            using (FileStream fs2 = new FileStream("document2.pdf", FileMode.Open))
            using (Document doc2 = new Document(fs2))
            {
                foreach (Page page in doc2.Pages)
                {
                    outputDoc.Pages.Add(page.Clone());
                }
            }

            // Save merged document
            using (FileStream output = new FileStream("merged.pdf", FileMode.Create))
            {
                outputDoc.Write(output);
            }
        }
    }
}
// NuGet: Install-Package TallComponents.PDF.Kit
using TallComponents.PDF.Kit;
using System.IO;

class Program
{
    static void Main()
    {
        // Create output document
        using (Document outputDoc = new Document())
        {
            // Load first PDF
            using (FileStream fs1 = new FileStream("document1.pdf", FileMode.Open))
            using (Document doc1 = new Document(fs1))
            {
                foreach (Page page in doc1.Pages)
                {
                    outputDoc.Pages.Add(page.Clone());
                }
            }

            // Load second PDF
            using (FileStream fs2 = new FileStream("document2.pdf", FileMode.Open))
            using (Document doc2 = new Document(fs2))
            {
                foreach (Page page in doc2.Pages)
                {
                    outputDoc.Pages.Add(page.Clone());
                }
            }

            // Save merged document
            using (FileStream output = new FileStream("merged.pdf", FileMode.Create))
            {
                outputDoc.Write(output);
            }
        }
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPDFのアプローチ:

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        // Load PDFs
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");

        // Merge PDFs
        var merged = PdfDocument.Merge(pdf1, pdf2);

        // Save merged document
        merged.SaveAs("merged.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        // Load PDFs
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");

        // Merge PDFs
        var merged = PdfDocument.Merge(pdf1, pdf2);

        // Save merged document
        merged.SaveAs("merged.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

TallComponentsバージョンでは、手作業によるページの反復と複製が必要です。 IronPdfはこれを単一のPdfDocument.Merge()呼び出しに削減します。 高度なマージシナリオについては、PDFマージドキュメントを参照してください。

透かしの追加

PDFに透かしを入れることで、開発者の経験におけるもう1つの大きな違いが明らかになります。

TallComponentsのアプローチ:

// NuGet: Install-Package TallComponents.PDF.Kit
using TallComponents.PDF.Kit;
using TallComponents.PDF.Layout;
using System.IO;
using System.Drawing;

class Program
{
    static void Main()
    {
        // Load existing PDF
        using (FileStream fs = new FileStream("input.pdf", FileMode.Open))
        using (Document document = new Document(fs))
        {
            // Iterate through pages
            foreach (Page page in document.Pages)
            {
                // Create watermark text
                TextShape watermark = new TextShape();
                watermark.Text = "CONFIDENTIAL";
                watermark.Font = new Font("Arial", 60);
                watermark.PenColor = Color.FromArgb(128, 255, 0, 0);
                watermark.X = 200;
                watermark.Y = 400;
                watermark.Rotate = 45;

                // Add to page
                page.Overlay.Shapes.Add(watermark);
            }

            // Save document
            using (FileStream output = new FileStream("watermarked.pdf", FileMode.Create))
            {
                document.Write(output);
            }
        }
    }
}
// NuGet: Install-Package TallComponents.PDF.Kit
using TallComponents.PDF.Kit;
using TallComponents.PDF.Layout;
using System.IO;
using System.Drawing;

class Program
{
    static void Main()
    {
        // Load existing PDF
        using (FileStream fs = new FileStream("input.pdf", FileMode.Open))
        using (Document document = new Document(fs))
        {
            // Iterate through pages
            foreach (Page page in document.Pages)
            {
                // Create watermark text
                TextShape watermark = new TextShape();
                watermark.Text = "CONFIDENTIAL";
                watermark.Font = new Font("Arial", 60);
                watermark.PenColor = Color.FromArgb(128, 255, 0, 0);
                watermark.X = 200;
                watermark.Y = 400;
                watermark.Rotate = 45;

                // Add to page
                page.Overlay.Shapes.Add(watermark);
            }

            // Save document
            using (FileStream output = new FileStream("watermarked.pdf", FileMode.Create))
            {
                document.Write(output);
            }
        }
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPDFのアプローチ:

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;

class Program
{
    static void Main()
    {
        // Load existing PDF
        var pdf = PdfDocument.FromFile("input.pdf");

        // Create watermark
        var watermark = new TextStamper()
        {
            Text = "CONFIDENTIAL",
            FontSize = 60,
            Opacity = 50,
            Rotation = 45,
            VerticalAlignment = VerticalAlignment.Middle,
            HorizontalAlignment = HorizontalAlignment.Center
        };

        // Apply watermark to all pages
        pdf.ApplyStamp(watermark);

        // Save watermarked PDF
        pdf.SaveAs("watermarked.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;

class Program
{
    static void Main()
    {
        // Load existing PDF
        var pdf = PdfDocument.FromFile("input.pdf");

        // Create watermark
        var watermark = new TextStamper()
        {
            Text = "CONFIDENTIAL",
            FontSize = 60,
            Opacity = 50,
            Rotation = 45,
            VerticalAlignment = VerticalAlignment.Middle,
            HorizontalAlignment = HorizontalAlignment.Center
        };

        // Apply watermark to all pages
        pdf.ApplyStamp(watermark);

        // Save watermarked PDF
        pdf.SaveAs("watermarked.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPdfのTextStamperクラスは直感的な配置オプションと自動ページ反復処理を提供します。 スタンプと透かしのガイドでは、その他のカスタマイズオプションについても説明しています。

デジタル署名

文書署名は、企業アプリケーションにとって非常に重要です。

TallComponentsのアプローチ:

using TallComponents.PDF.Kit;
using TallComponents.PDF.Kit.Signing;

Document document = new Document("unsigned.pdf");

// Load certificate
X509Certificate2 cert = new X509Certificate2("certificate.pfx", "password");

// Create signature
SignatureHandler handler = new SignatureHandler(cert);
document.Sign(handler);

document.Write("signed.pdf");
using TallComponents.PDF.Kit;
using TallComponents.PDF.Kit.Signing;

Document document = new Document("unsigned.pdf");

// Load certificate
X509Certificate2 cert = new X509Certificate2("certificate.pfx", "password");

// Create signature
SignatureHandler handler = new SignatureHandler(cert);
document.Sign(handler);

document.Write("signed.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPDFのアプローチ:

using IronPdf;
using IronPdf.Signing;

var pdf = PdfDocument.FromFile("unsigned.pdf");

// Sign with certificate
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "support@company.com",
    SigningLocation = "New York",
    SigningReason = "Document Approval"
};

pdf.Sign(signature);
pdf.SaveAs("signed.pdf");
using IronPdf;
using IronPdf.Signing;

var pdf = PdfDocument.FromFile("unsigned.pdf");

// Sign with certificate
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "support@company.com",
    SigningLocation = "New York",
    SigningReason = "Document Approval"
};

pdf.Sign(signature);
pdf.SaveAs("signed.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPdfの署名APIには、連絡先、場所、署名理由などのメタデータプロパティが追加されています。 完全な実装の詳細については、デジタル署名ドキュメントを参照してください。

機能の比較:TallComponents vs IronPdf

フィーチャートールコンポーネントIronPDF
<ステータス販売終了 ❌ 販売終了アクティブ
サポート❌ なしフル
更新情報❌ なしレギュラー
コンテンツ作成
HTMLからPDFへなし完全なChromium
URLからPDFへなしはい
CSSサポートなし完全なCSS3
JavaScriptなしフルES2024
XMLテンプレートはい不要
PDFオペレーション
PDFのマージはいはい
PDFの分割はいはい
透かしマニュアル内蔵
ヘッダー/フッターXMLベースHTML/CSS
セキュリティ
パスワード保護はいはい
デジタル署名はいはい
暗号化はいはい
PDF/A制限的はい
既知の問題
空白ページ⚠️ 文書化されたバグなし
不足しているグラフィック⚠️ 文書化されたバグなし
フォントの問題⚠️ 文書化されたバグなし
開発分野
学習曲線高(XML)低レベル(HTML)
ドキュメンテーション古い広範囲
コミュニティなし活発

TallComponents移行チェックリスト

マイグレーション前のタスク

コードベースを監査して、TallComponents の使用法をすべて特定してください:

grep -r "using TallComponents" --include="*.cs" .
grep -r "Document\|Section\|TextParagraph" --include="*.cs" .
grep -r "using TallComponents" --include="*.cs" .
grep -r "Document\|Section\|TextParagraph" --include="*.cs" .
SHELL

既存のXMLテンプレートとレイアウトを文書化し、HTMLに変換する。 現在使用されているセキュリティ設定を特定し、パスワード設定とデジタル署名の実装に言及すること。

コード更新タスク

1.NuGet経由でTallComponentsパッケージを削除する 2.IronPdfパッケージをインストールする 3.XMLレイアウトをHTMLテンプレートに変換 4.セクション/パラグラフモデルをHTML要素に置き換える 5.標準的なHTMLテーブルを使用するようにテーブルコードを更新 6.HtmlHeaderFooterでヘッダー/フッターを HTML に変換します。 7.pdf.SecuritySettingsを使用するようにセキュリティ設定を更新してください。 8.起動時のライセンス初期化を追加

ヘッダーとフッターの移行

TallComponentsはXMLベースのヘッダーを使用します。 IronPdfは動的プレースホルダーを持つHTMLベースのヘッダーを提供します:

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Header Text</div>",
    MaxHeight = 25
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Footer Text</div>",
    MaxHeight = 25
};
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Header Text</div>",
    MaxHeight = 25
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Footer Text</div>",
    MaxHeight = 25
};
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPDFのヘッダーとフッターについてはこちらをご覧ください。

テスト段階

1.TallComponentsとIronPDFのビジュアル出力の比較 2.空白ページの問題が解決されていることを確認 3.すべてのドキュメントテンプレートのテスト 4.PDFマージ機能の検証 5.デジタル署名のテスト 6.セキュリティ設定が正しく適用されることを確認する

推奨される移行スケジュール

TallComponentsはサポートが終了しているため、早急に移行を進める必要があります:

第1週:コードベースを監査し、すべてのTallComponentsの使用法を特定する。 第2週:ドキュメントテンプレートをXMLからHTMLに変換する 第3週:セキュリティの更新、マージ、コードの署名 第4週: テストと本番デプロイメント

翻訳が遅れるということは、レンダリングバグが文書化された未サポートのソフトウェアを実行するということであり、2026年に向けてプロの開発チームが受け入れるべきリスクではありません。

主な移行のメリット

TallComponentsからIronPDFに移行することで、すぐにメリットが得られます:

最新のChromiumレンダリングエンジン:完全なCSSとJavaScriptのサポートにより、PDFが期待通りにレンダリングされ、TallComponentsで文書化された空白ページやグラフィックが欠落するバグを排除します。

積極的なメンテナンスとセキュリティアップデート: IronPDFは定期的にアップデートを行い、.NET 10を含む現在および将来の.NETバージョンとの互換性を保証します。

より優れた.NET統合:ネイティブのasync/awaitサポートと最新のAPIパターンは、現代のC#開発プラクティスと一致しています。

包括的なドキュメント: 豊富なチュートリアルAPIリファレンスは、迅速な実装をサポートします。

結論

ApryseによるTallComponentsの買収は、.NET開発者にとって明確な移行の必要性を生み出しました。 新しいライセンスが利用できず、既存ユーザーへのサポートもなく、レンダリングのバグも文書化されていますが、修正されることはありません。

IronPDFは、よりクリーンなAPI、モダンなHTMLベースのレンダリング、アクティブな開発により、直接的な移行パスを提供します。 このガイドのコード例では、TallComponentsのパターンがどのようにIronPdfと同等のものに変換されるかを示しています。

IronPDFの無料トライアルで今すぐ移行を開始し、PDF生成インフラを長期的な成功に導いてください。

カーティス・チャウ
テクニカルライター

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

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