.NET CoreでASP HTMLをPDFに変換する方法

NuGetパッケージマネージャー経由でのインストール

Visual StudioのNuGetパッケージマネージャーを通じて、IronPDFをHTMLからPDFに変換するためにASP.NETプロジェクトに追加するのが最も迅速な方法です。 ソリューションエクスプローラーでプロジェクトを右クリックし、"NuGetパッケージの管理"を選択し、IronPDFを検索します。 最新バージョンをインストールしてプロジェクトに追加します。 詳細なインストール手順については、IronPDFインストールガイドをご覧ください。

Install-Package IronPdf

必要な名前空間の追加

インストール後、PDF生成で作業するC#ファイルにIronPDF名前空間を追加します。

using IronPdf;

using IronPdf;

Imports IronPdf

このシンプルなインポート宣言により、HTML変換のためのChromePdfRendererクラスおよびPDF出力をカスタマイズするためのさまざまな設定オプションを含む、すべてのIronPDFの機能にアクセスできます。

基本設定

ほとんどのASP.NET Coreアプリケーションでは、追加の設定なしでインストール直後にIronPDFが機能します。 ただし、Program.csまたはStartup.csファイルでグローバルオプションを設定することができます。

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;

IRON VB CONVERTER ERROR developers@ironsoftware.com

これらの設定オプションは、Windows、LinuxまたはDockerコンテナ上で実行しているかどうかに関わらず、あなたの特定のホスティング環境にIronPDFを最適化するのに役立ちます。 スクリプトとアプリケーションファイルが同じディレクトリに置かれないようにして、競合を避けてください。

CSSと画像の操作

IronPDFは、CSSスタイリングを完全にサポートし、さまざまなソースから画像を埋め込んでHTMLをPDFに変換することができます。 PDFコンバーターは、さまざまなHTMLタグや画像URLを含むHTMLエレメントを完全に忠実に処理します。

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

IRON VB CONVERTER ERROR developers@ironsoftware.com

レンダラーは、インラインスタイル、CSSファイル、さらにはbase64エンコードされた画像も処理します。 これにより、flexboxやグリッドレイアウトなどの最新のCSS3機能を含むHTMLコンテンツの正確な外観でPDFページを維持します。 HTMLからPDFへの変換は、白紙ページを生成することなく、すべてのHTMLタグとそのスタイルを保持します。

コントローラーのビューの変換

ASP.NET Coreコントローラー内でビューをHTMLにレンダリングし、IronPDFの強力なPDFライブラリレンダリング機能を使用してPDFドキュメントに変換できます。

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

このアプローチでは、最初にRazorビューをHTML文字列にレンダリングし、それをPDFに変換します。 PDFは適切なファイル名でユーザーのブラウザにファイルダウンロードとして返されます。 これは、ASPXファイルや最新のRazorビューを変換する際にシームレスに動作します。

URLをPDFに変換する

既存のウェブページに対して、指定されたURLを直接PDFファイルに変換するためにIronPDFの強力なHTMLからPDFコンバーターを使用できます。 HTTPまたはHTTPSのアドレスをURLパラメーターとして提供するだけです。

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

このメソッドは、すでにフォーマットされたウェブページがあり、それをダウンロード用PDFバージョンとして提供したいときに特に便利です。 .NETライブラリは、スタイルシート、スクリプト、および画像を含むすべての外部リソースを処理し、完全なHTMLレンダリングを保証します。 無効なURLに遭遇すると、コンバーターは適切なHTTPステータスコードを返します。

認証の処理

.NETフォーム認証やその他のセキュリティメカニズムを使用して認証されたページを変換する際に、クッキーやヘッダーを渡して同じユーザーアカウントセッションを維持することができます。 これにより、PDF変換中にログイン画面へのリダイレクトを防ぎます。

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");

IRON VB CONVERTER ERROR developers@ironsoftware.com

これにより、保護されたHTMLコンテンツが、セキュリティを維持したままPDFファイルに変換できるようになります。 PDF変換プロセスは、アプリケーションの基本認証およびフォーム認証を尊重し、敏感な既存のドキュメントへの不正なユーザーアカウントアクセスを防ぎます。 必要に応じて、基本認証シナリオのためにユーザー名とパスワードの引数を渡すこともできます。

ページ設定および余白

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

IRON VB CONVERTER ERROR developers@ironsoftware.com

これらの設定は、奇数ページと偶数ページの両方を含むPDFページの物理的レイアウトを制御します。 標準的な用紙サイズから選択するか、カスタム寸法を定義し、縦向きまたは横向きを設定し、複数ページのデザイン要件に合わせて余白を調整できます。 グラフィックステンプレートシステムは、後続の奇数ページと偶数ページ間で一貫したスタイリングを保証します。

ヘッダーとフッター

HTMLドキュメントを変換する際、コンスタントなヘッダーとフッターを追加することで、PDFドキュメントのプロフェッショナルな外観が向上します。

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

IRON VB CONVERTER ERROR developers@ironsoftware.com

ヘッダーとフッターは、ページ番号、日付、および他の動的コンテンツのための特別なプレースホルダーを含め、すべてのPDFページでHTML要素とフォーマットをサポートします。 次のコードは、動的に生成されたドキュメントまたは既存のPDFドキュメントにプロフェッショナルなヘッダーを追加する方法を示します。