Byte ArrayからC# iTextSharpでPDFを作成（対 IronPDF）

iText 7はiTextSharpの正式な後継で、完全に再設計されたアーキテクチャを提供します。 これは、法的、金融、政府のようなコンプライアンス重視の業界でPDFを作成、編集、および検証するための強力で拡張可能なライブラリです。 iText 7スイートは、PDF/A、PDF/UA、デジタル署名、墨消し、およびフォーム作成のサポートを含みます。

まだAGPLライセンスのオープンソースですが、商用プロジェクトには商用ライセンスが利用可能です。

iText 7の主な特徴

• 現代的なAPIで、古い構造を持つiTextSharpを置き換える
• モジュラーサポート: HTML to PDF、PDF/A、フォーム、墨消し、デジタル署名
• 企業向けアプリケーションのための高性能
• PDF/A、アクセシビリティ、コンプライアンスに最適

インストール (NuGet)

iText 7のPDF生成用コアパッケージをダウンロードするには：

Install-Package itext7

iText 7は、ソリューション画面のパッケージマネージャを介してインストールすることもできます。 これを行うには、まずツールドロップダウンメニューを開き、"NuGet パッケージ マネージャ > ソリューションの NuGet パッケージを管理"を見つけます。

その後、"iText 7"を検索し、"インストール"をクリックするだけです。

コード例：バイト配列を使用してiText 7でPDFドキュメントを作成

using System.IO;
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfWithIText7();
        // Save the PDF to a file
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfWithIText7()
    {
        using (var ms = new MemoryStream())
        {
            var writer = new PdfWriter(ms);
            var pdf = new iText.Kernel.Pdf.PdfDocument(writer);
            var doc = new Document(pdf);

            doc.Add(new Paragraph("Hello from iText 7 for .NET!"));

            doc.Close(); // Always close the document to finalize content  
            return ms.ToArray();
        }
    }
}

using System.IO;
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfWithIText7();
        // Save the PDF to a file
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfWithIText7()
    {
        using (var ms = new MemoryStream())
        {
            var writer = new PdfWriter(ms);
            var pdf = new iText.Kernel.Pdf.PdfDocument(writer);
            var doc = new Document(pdf);

            doc.Add(new Paragraph("Hello from iText 7 for .NET!"));

            doc.Close(); // Always close the document to finalize content  
            return ms.ToArray();
        }
    }
}

PDFファイルの出力

説明

• PdfWriter は内容を MemoryStream に書き込みます。
• PdfDocument は PDF の内部構造を管理します。
• Document は、高レベルのコンテンツ (テキスト、画像、表) を追加するために使用されます。
• doc.Close() を呼び出した後、PDF コンテンツが完全に書き込まれ、バイト配列として返される準備が整います。

この例は、iText 7のよりモジュール化され、読みやすいAPIをiTextSharpと比較して示しています。ただし、pdfhtmlを含めない限り、HTML/CSSのレンダリングに対するネイティブサポートはまだ不足しています。

iText 7の利点と欠点

利点:

• 包括的なPDF制御\ iText 7は、テーブル、フォーム、デジタル署名などのPDF要素を完全に制御します。 これにより、PDF/AやPDF/UAなどの特定のPDF標準を必要とするコンプライアンス重視のアプリケーションに最適です。

• モジュラーかつスケーラブル\ iText 7はモジュラー設計を採用しており、必要な特定のモジュールのみをインストールできます(例: HTMLからPDFへの変換のためのpdfhtml)。 これにより、すべての機能を使用しない場合は、軽量な実装が可能になります。

• 複雑なPDF規格をサポート\ iText 7は、ISO規格であるPDF/A(アーカイブ)、PDF/UA(アクセシビリティ)、PDF/X(印刷)をサポートしており、コンプライアンスが重要なプロフェッショナルおよび法的環境に適しています。

• 豊富なドキュメントとサポート\ iText 7は、包括的なドキュメントと大規模なコミュニティを持っています。 また、会社はプロフェッショナルサポートを提供しており、開発者が必要なときに支援を受けられます。

• 無料版利用可能(AGPL)\ 開発者は、iText 7をAGPLライセンスの下で無料で使用でき、オープンソースプロジェクトや個人的な使用に最適です。

欠点:

• 商用利用のためのAGPLライセンス\ iText 7は無料版を提供していますが、商用利用者はAGPLライセンスに従わなければならず、iText 7を使用したソフトウェアのソースコードを公開するか、商用ライセンスを購入する必要があります。

• 急な学習曲線\ iText 7のAPIは、より複雑かつ機能豊富であるため、IronPDFのようなシンプルなライブラリに比べて学習曲線が急です。 開発者は、その低レベルの文書構造とモジュール基盤のアーキテクチャを習得する必要があります。

• 単純なタスクには過剰\ iText 7は、IronPDFのようにプロセスを簡素化するライブラリと比較して、単純な文書作成や基本的なHTMLからPDFへの変換など、基本的なPDFタスクには煩雑に感じるかもしれません。

• HTMLからPDFへの変換には外部モジュールが必要\ iText 7のHTMLからPDFへの変換は、追加のpdfhtmlモジュールを通じてのみ利用可能であり、別途インストールが必要で、IronPDFほどスムーズに現代のウェブコンテンツを処理できない可能性があります。

IronPDFは、開発者の生産性に焦点を当てたPDF文書生成を簡素化するために設計された高レベル for .NETライブラリです。 特にHTMLコンテンツとスタイリングのレンダリングに効果的で、現代のWebからPDFへのワークフローに最適です。

主な特徴：

• バイト配列からPDFファイルを作成し、Adobe ReaderをインストールせずにPDF文書を操作
• 完全なChromiumエンジンを使用した直接的なHTMLからPDFへのレンダリングでHTMLコンテンツからPDF文書を作成
• MVCビュー、Razorページ、ローカルおよびリモートURLで動作
• 画像ファイル、JavaScript、CSS、およびレスポンシブレイアウトをアウトオブザボックスでサポート
• 簡単に使用できる構文と最小限のセットアップ
• 永続的なライセンスとAGPL制約なし

IronPDFもまた、NuGetを介してインストール可能で、NuGet パッケージ マネージャーコンソールで次のコマンドを実行してインストールします：

Install-Package IronPdf

または、NuGetパッケージマネージャでソリューション画面からインストールすることができます。 これを行うには、"ツール > NuGetパッケージマネージャ > ソリューションのNuGetパッケージを管理"へ移動します。

その後、"IronPDF"を検索し、"インストール"をクリックします。

インストール後、フルHTMLページのPDFへのレンダリングを数秒で開始できます—追加のモジュールは必要ありません。 モダンなCSS、JavaScript、インタラクティブなウェブコンテンツを追加設定なしでサポートします。

コード例：バイト配列でIronPDFを使用してPDFドキュメントを作成

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfWithIronPdf();
        // Save the PDF to a file
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfWithIronPdf()
    {
        var renderer = new ChromePdfRenderer();
        var pdfDoc = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
        return pdfDoc.BinaryData;
    }
}

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfWithIronPdf();
        // Save the PDF to a file
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfWithIronPdf()
    {
        var renderer = new ChromePdfRenderer();
        var pdfDoc = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
        return pdfDoc.BinaryData;
    }
}

PDFファイルの出力

説明

• using IronPdf ステートメントは、すべての PDF 関連クラスにアクセスするためにIronPDFライブラリをインポートします。
• var renderer = new ChromePdfRenderer() は、ヘッドレス Chromium エンジンを搭載した新しい HTML から PDF へのレンダラーを作成します。
• renderer.RenderHtmlAsPdf(...) は指定された HTML 文字列を PDF ドキュメントに変換します。 また、ファイルパスやURLを渡すこともできます。
• pdfDoc.BinaryData は、保存、ストリーミング、またはデータベース ストレージの準備が整ったバイト配列として最終的な PDF を返します。

IronPDFの利点と欠点

利点:

• 簡単なHTMLからPDFへのレンダリング\ 完全なスタイリングでHTML、CSS、JavaScriptコンテンツをまっすぐにPDFにレンダリング、複雑なレイアウトコードや追加モジュールは不要です。

• クイックスタートと直感的なAPI\ クリーンな構文と完全な.NET Coreおよび.NET Frameworkの互換性を持ち、わずか数行のコードでフルスタイルのPDFファイルを作成します。

• ウェブテクノロジーの包括的なサポート\ IronPDFは、JavaScript、モダンCSS、SVG、メディアクエリをサポートしており、Chromiumのようなヘッドレスブラウザを内部で使用しなければ多くのライブラリが苦しむ領域をカバーしています。

• ビルトインの画像とアセット処理\ 追加設定なしで、画像、ローカルファイル、さらにはリモートURLからアセットを簡単に含むことができます。

• 永続ライセンスとAGPLなし\ iText 7とは異なり、IronPDFは、オープンソースのAGPL義務の制約なしで商用ライセンスを柔軟に提供します。

• MVCとRazorビューのために優秀\ ASP.NETアプリケーションで.cshmtl Razor Viewsをシームレスに印刷可能なPDFに変換します。

欠点:

商用利用にはライセンスが必要\ 無料トライアルがありますが、IronPDFはオープンソースではありません。 予算の厳しいプロジェクトはライセンスコストを評価する必要があります。

• 初期パッケージサイズが大きい\ ヘッドレスChromiumエンジンをバンドルしているため、NuGetパッケージは一部の代替品よりも重いです。

IronPDF

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfFromUrlWithIronPdf();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-from-url.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfFromUrlWithIronPdf()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.WaitForJavaScript(5000);
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

        var pdf = renderer.RenderUrlAsPdf("https://www.apple.com");
        return pdf.BinaryData;
    }
}

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfFromUrlWithIronPdf();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-from-url.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfFromUrlWithIronPdf()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.WaitForJavaScript(5000);
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

        var pdf = renderer.RenderUrlAsPdf("https://www.apple.com");
        return pdf.BinaryData;
    }
}

出力PDF

IronPDFは、完全なJavaScriptとCSSのサポートを備えたウェブページのためのピクセルパーフェクトレンダリングをヘッドレスChromiumエンジンを使用して提供します。

iText 7

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using System.Net.Http;
using System.Threading.Tasks;
using iText.Html2pdf;
using System.IO;

class Program
{
    static async Task Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = await pdfGenerator.GeneratePdfFromUrlWithIText7Async();

        // Save the PDF to a file
        File.WriteAllBytes("itext7-from-url.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public async Task<byte[]> GeneratePdfFromUrlWithIText7Async()
    {
        using var httpClient = new HttpClient();
        string html = await httpClient.GetStringAsync("https://www.apple.com");

        using var stream = new MemoryStream();
        HtmlConverter.ConvertToPdf(html, stream);
        return stream.ToArray();
    }
}

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using System.Net.Http;
using System.Threading.Tasks;
using iText.Html2pdf;
using System.IO;

class Program
{
    static async Task Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = await pdfGenerator.GeneratePdfFromUrlWithIText7Async();

        // Save the PDF to a file
        File.WriteAllBytes("itext7-from-url.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public async Task<byte[]> GeneratePdfFromUrlWithIText7Async()
    {
        using var httpClient = new HttpClient();
        string html = await httpClient.GetStringAsync("https://www.apple.com");

        using var stream = new MemoryStream();
        HtmlConverter.ConvertToPdf(html, stream);
        return stream.ToArray();
    }
}

出力

iText 7は、HttpClientを使用して生のHTMLをフェッチし、HtmlConverterを使用してレンダリングしますが、JavaScriptの実行をサポートしていません(iTextの公式ドキュメントで、JavaScriptの事前処理にSeleniumや同様のブラウザオートメーションの使用を推奨しているため確認済み)で、CSSスタイリングが制限されています。 iText7は、バージョン7.1.15(2021年)で部分的なflexboxサポートを追加しましたが、多くのCSS3プロパティは、特に複雑なモダンレイアウトにおいて未サポートのままです。

IronPDF

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-with-image.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreatePdfWithImage()
    {
        var pdf = ImageToPdfConverter.ImageToPdf("example.png");
        return pdf.BinaryData;
    }
}

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-with-image.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreatePdfWithImage()
    {
        var pdf = ImageToPdfConverter.ImageToPdf("example.png");
        return pdf.BinaryData;
    }
}

出力

IronPDFのImageToPdfConverterツールを使用した、簡単な画像からPDFの生成。 これにより、PNGファイルやJPGなどの画像から簡単にPDFファイルを作成できます。

iText 7

using iText.Kernel.Pdf;
using iText.Layout;
using iText.IO.Image;
using iText.Layout.Element;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();

        // Save the PDF to a file
        File.WriteAllBytes("iText-with-image.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreatePdfWithImage()
    {
        using var ms = new MemoryStream();
        using var writer = new PdfWriter(ms);
        using var pdfDoc = new iText.Kernel.Pdf.PdfDocument(writer);
        var document = new Document(pdfDoc);

        var img = new Image(ImageDataFactory.Create("https://itextpdf.com/sites/default/files/2018-11/iText%207%20Product%20software%20-%20webimages_509x339px_V2_iText%207%20Core.png"));
        document.Add(img);
        document.Close();

        return ms.ToArray();
    }
}

using iText.Kernel.Pdf;
using iText.Layout;
using iText.IO.Image;
using iText.Layout.Element;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();

        // Save the PDF to a file
        File.WriteAllBytes("iText-with-image.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreatePdfWithImage()
    {
        using var ms = new MemoryStream();
        using var writer = new PdfWriter(ms);
        using var pdfDoc = new iText.Kernel.Pdf.PdfDocument(writer);
        var document = new Document(pdfDoc);

        var img = new Image(ImageDataFactory.Create("https://itextpdf.com/sites/default/files/2018-11/iText%207%20Product%20software%20-%20webimages_509x339px_V2_iText%207%20Core.png"));
        document.Add(img);
        document.Close();

        return ms.ToArray();
    }
}

出力

ImageDataFactoryを使用した文書レイアウトの手動作成と明示的な画像挿入。

IronPDF

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreateStyledPdf();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-styled-html.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreateStyledPdf()
    {
        string html = @"
        <html>
            <head>
                <style>
                    body { 
                        background-color: #f0f0f0; 
                        margin: 20px; 
                        padding: 20px; 
                        border-radius: 5px; 
                        box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
                    }
                    h1 { 
                        color: navy;
                        font-size: 32px;   
                        text-align: center;
                       }
                    p { 
                        font-size: 16px; 
                        font-weight: bold;
                      }
                </style>
            </head>
            <body>
                <h1>Welcome to IronPDF</h1>
                <p>This is a simple PDF document generated using IronPDF.</p>
            </body>
        </html>";

        var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(html);
        return pdf.BinaryData;
    }
}

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreateStyledPdf();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-styled-html.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreateStyledPdf()
    {
        string html = @"
        <html>
            <head>
                <style>
                    body { 
                        background-color: #f0f0f0; 
                        margin: 20px; 
                        padding: 20px; 
                        border-radius: 5px; 
                        box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
                    }
                    h1 { 
                        color: navy;
                        font-size: 32px;   
                        text-align: center;
                       }
                    p { 
                        font-size: 16px; 
                        font-weight: bold;
                      }
                </style>
            </head>
            <body>
                <h1>Welcome to IronPDF</h1>
                <p>This is a simple PDF document generated using IronPDF.</p>
            </body>
        </html>";

        var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(html);
        return pdf.BinaryData;
    }
}

出力

IronPDFはそのChromiumエンジンのおかげで、タグや外部スタイルシート内のCSSを完全にサポートしています。

iText 7 + pdfHTML

using iText.Kernel.Pdf;
using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreateStyledPdf();

        // Save the new document to the specified file location
        File.WriteAllBytes("iText-styled-html.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreateStyledPdf()
    {
        string html = @"
        <html>
            <head>
                <style>
                    body { 
                        background-color: #f0f0f0; 
                        margin: 20px; 
                        padding: 20px; 
                        border-radius: 5px; 
                        box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
                    }
                    h1 { 
                        color: navy;
                        font-size: 32px;   
                        text-align: center;
                       }
                    p { 
                        font-size: 16px; 
                        font-weight: bold;
                      }
                </style>
            </head>
            <body>
                <h1>Welcome to iText 7</h1>
                <p>This is a simple PDF document generated using iText 7 and pdfHTML.</p>
            </body>
        </html>";

        using var ms = new MemoryStream();
        ConverterProperties properties = new ConverterProperties();
        HtmlConverter.ConvertToPdf(new MemoryStream(System.Text.Encoding.UTF8.GetBytes(html)), ms, properties);
        return ms.ToArray();
    }
}

using iText.Kernel.Pdf;
using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreateStyledPdf();

        // Save the new document to the specified file location
        File.WriteAllBytes("iText-styled-html.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreateStyledPdf()
    {
        string html = @"
        <html>
            <head>
                <style>
                    body { 
                        background-color: #f0f0f0; 
                        margin: 20px; 
                        padding: 20px; 
                        border-radius: 5px; 
                        box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
                    }
                    h1 { 
                        color: navy;
                        font-size: 32px;   
                        text-align: center;
                       }
                    p { 
                        font-size: 16px; 
                        font-weight: bold;
                      }
                </style>
            </head>
            <body>
                <h1>Welcome to iText 7</h1>
                <p>This is a simple PDF document generated using iText 7 and pdfHTML.</p>
            </body>
        </html>";

        using var ms = new MemoryStream();
        ConverterProperties properties = new ConverterProperties();
        HtmlConverter.ConvertToPdf(new MemoryStream(System.Text.Encoding.UTF8.GetBytes(html)), ms, properties);
        return ms.ToArray();
    }
}

出力

HTML変換タスクを処理するためには有料のアドオンであるpdfHTMLのインストールが必要です。