ASP.NET C#とIronPDFでPDFを新しいウィンドウで開く方法

PDF 表示の問題をなぜ気にする必要があるのでしょうか?

ASP.NETでPDFファイルを提供する場合、デフォルトの動作では、ブラウザの表示ではなく、ダウンロードになることがよくあります。 これは、サーバーがHTTP 応答ヘッダーを通じてブラウザにファイルを送信する方法が原因で発生します。 Content-Disposition ヘッダーは、PDF ファイルがインラインで開くかダウンロードされるかを制御します。

バイト配列で Response.BinaryWrite を使用する従来のASP.NETコードでは、ダウンロードをトリガーするヘッダーが設定されることが多いです。 開発者が Response.ContentType = "application/pdf" を設定した場合でも、Content-Disposition の値が欠落しているか正しくない場合は、ブラウザはPDF ドキュメントを表示せずにダウンロードします。 また、ブラウザによって PDF ファイルの処理方法に一貫性がありません。一部のデスクトップ ブラウザではデフォルトでファイルがインラインで表示されますが、モバイル ブラウザではデフォルトでダウンロードされることがよくあります。

これらの問題はいつ最も頻繁に発生しますか?

HTML 文字列またはデータベース ソースから動的に生成された PDF ドキュメントを操作する場合、サーバー側の構成はより複雑になります。 正しいパスと適切なヘッダーがなければ、ブラウザ間で一貫した表示を実現するのは非常に困難です。 多くの開発者は、この根深い問題の解決策を求めてStack Overflowに目を向けます。 MDN Web Docs の Content-Disposition に関するエントリは、インライン値と添付ファイル値の正確な構文とブラウザーの動作を理解するための信頼できるリファレンスです。

IronPDF のアプローチが他と異なる点は何ですか?

ライブラリのChromePdfRendererクラスは、PDF 作成のための最新のアプローチを提供します。 開発者は、バイト配列と応答ストリームを手動で管理する代わりに、単純なメソッド呼び出しを使用してHTML 文字列、HTML ファイル、または URL から PDF を生成できます。 IronPDFはレンダリングプロセスを内部で処理し、異なる環境でも一貫した出力を保証します。

どの機能が最も役立ちますか?

IronPDF は、基本的な生成に加えて、用紙サイズ、余白、 JavaScript実行の遅延など、出力をカスタマイズするための広範なレンダリング オプションを提供します。 この柔軟性により、単純なドキュメントからグラフや動的なコンテンツを含む複雑なレポートまで、あらゆるものを作成するのに適しています。

レンダリング エンジンは、カスタム ヘッダーとフッター、透かし、ページ番号もサポートします。これらはすべて、レンダリング メソッドを呼び出す前に、簡単なオプション オブジェクトを通じて構成されます。 既存のブランド スタイル ガイドに合わせる必要がある開発者にとって、出力形式をこのレベルで制御できることは、PDF バイナリ データを手動で作成する場合に比べて大きな利点となります。

生成されたPDFはどのように見えますか?

上記のコードでは、[HttpGet] が使用されています。 ユーザーがフォームを送信した後に PDF を作成する場合は、代わりに [HttpPost] 属性を使用します。 この区別は重要です。GET リクエストはべき等である必要があり、POST リクエストはパーソナライズされたドキュメントを生成するために使用される送信されたフォーム データを伝送します。

Response.Headers.Add ではなく Response.Headers.Append が使用されていることに注意してください。 ASP.NET Coreでは、ヘッダーが既に存在する場合にエラーをスローしないため、応答ヘッダーを追加する場合は Append メソッドが推奨される API です。 Add を使用すると、ヘッダーが部分的に設定されている可能性があるミドルウェア パイプラインで例外が発生する可能性があります。

Content-Disposition ヘッダーが重要なのはなぜですか?

ブラウザーで PDF ファイルを開くための重要な詳細は、Content-Disposition ヘッダーを "attachment" ではなく "inline" に設定することです。 "attachment" 値は、ブラウザにファイルをダウンロードしてディスクに保存するように指示します。 これを "inline" に設定すると、ブラウザはブラウザ ウィンドウ内にファイルを表示しようとします。これは、ネイティブ PDF レンダリングをサポートする最新のブラウザでは自動的に実行されます。

これを WebForms でどのように実装するのでしょうか?

WebForms アプリケーションの場合、HTTP 応答を通じて PDF を直接提供し、ボタンのクリック イベントからブラウザーの表示をトリガーできます。

using IronPdf;

protected void OpenPdf_Click(object sender, EventArgs e)
{
    var renderer = new ChromePdfRenderer();

    // Generate PDF from HTML content
    var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Your order details</p>");

    // Get byte array from the PDF document
    byte[] data = pdf.BinaryData;

    // Clear any existing response output
    Response.Clear();
    Response.ContentType = "application/pdf";
    Response.AddHeader("Content-Length", data.Length.ToString());
    Response.AddHeader("Content-Disposition", "inline; filename=invoice.pdf");
    Response.BinaryWrite(data);
    Response.End();
}

using IronPdf;

protected void OpenPdf_Click(object sender, EventArgs e)
{
    var renderer = new ChromePdfRenderer();

    // Generate PDF from HTML content
    var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Your order details</p>");

    // Get byte array from the PDF document
    byte[] data = pdf.BinaryData;

    // Clear any existing response output
    Response.Clear();
    Response.ContentType = "application/pdf";
    Response.AddHeader("Content-Length", data.Length.ToString());
    Response.AddHeader("Content-Disposition", "inline; filename=invoice.pdf");
    Response.BinaryWrite(data);
    Response.End();
}

Imports IronPdf

Protected Sub OpenPdf_Click(sender As Object, e As EventArgs)
    Dim renderer As New ChromePdfRenderer()

    ' Generate PDF from HTML content
    Dim pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Your order details</p>")

    ' Get byte array from the PDF document
    Dim data As Byte() = pdf.BinaryData

    ' Clear any existing response output
    Response.Clear()
    Response.ContentType = "application/pdf"
    Response.AddHeader("Content-Length", data.Length.ToString())
    Response.AddHeader("Content-Disposition", "inline; filename=invoice.pdf")
    Response.BinaryWrite(data)
    Response.End()
End Sub

PDF フォームを作成したり、デジタル署名を追加したりする必要がある場合、 IronPDF はこれらの高度な機能の両方に対する組み込みサポートを提供します。

PDF は新しいタブにどのように表示されますか?

より詳細な制御のためにJavaScriptを使用する必要があるのはいつですか?

URL が動的に決定されるシナリオでは、JavaScript の window.open 関数を使用すると、PDF タブがいつどのように開くかを正確に制御できます。

function openPdfInNewTab() {
    // Open the PDF endpoint in a new browser tab
    window.open('/Pdf/GeneratePdf', '_blank');
    return false; // Prevent default link or form submission behavior
}

function openPdfInNewTab() {
    // Open the PDF endpoint in a new browser tab
    window.open('/Pdf/GeneratePdf', '_blank');
    return false; // Prevent default link or form submission behavior
}

JavaScriptとASP.NETコントロールをどのように組み合わせるのでしょうか?

ASP.NET WebForms アプリケーションでは、OnClientClick 属性を使用して、 JavaScript呼び出しをボタン コントロールに直接アタッチします。

<asp:Button ID="btnViewPdf" runat="server"
            OnClientClick="window.open('/Pdf/GeneratePdf', '_blank'); return false;"
            Text="Open PDF in New Tab" />

<asp:Button ID="btnViewPdf" runat="server"
            OnClientClick="window.open('/Pdf/GeneratePdf', '_blank'); return false;"
            Text="Open PDF in New Tab" />

<asp:Button ID="btnViewPdf" runat="server"
            OnClientClick="window.open('/Pdf/GeneratePdf', '_blank'); return false;"
            Text="Open PDF in New Tab" />

window.open() を使用する場合、2 番目の引数 '_blank' は、ドキュメントを新しい別のウィンドウまたはタブで開くターゲット パラメーターです。 これは、標準の HTML アンカー タグの target="_blank" の動作を反映します。

PDF をページに直接埋め込むとどうなるでしょうか?

HTML の <object> タグは、 PDF ドキュメントを現在のページに直接埋め込む別のオプションを提供します。これは、ユーザーがドキュメントを他のコンテンツと一緒に読む必要がある場合に便利です。

<object data="/Pdf/GeneratePdf" type="application/pdf" width="100%" height="600px">
    <embed src="/Pdf/GeneratePdf" type="application/pdf" />
    <p>Your browser does not support embedded PDF documents.
       <a href="/Pdf/GeneratePdf" target="_blank">View the PDF file</a>
    </p>
</object>

<object data="/Pdf/GeneratePdf" type="application/pdf" width="100%" height="600px">
    <embed src="/Pdf/GeneratePdf" type="application/pdf" />
    <p>Your browser does not support embedded PDF documents.
       <a href="/Pdf/GeneratePdf" target="_blank">View the PDF file</a>
    </p>
</object>

埋め込まれた PDF はどのように見えるでしょうか?

このアプローチは、ネイティブ PDF レンダリングをサポートする最新のブラウザで適切に機能します。 Microsoft のASP.NET Coreドキュメントによると、適切なHTTP ヘッダーとクライアント側コードを組み合わせることで、最も信頼性の高いクロスブラウザー ソリューションが実現します。 フォールバック リンクでは target="_blank" 属性が必須であることに注意してください。

既存の PDF ファイルを読み込むにはどうすればよいでしょうか?

既存のPDF ドキュメントをディスクから読み込み、インラインで提供するには:

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]")]
public class PdfController : Controller
{
    private readonly IWebHostEnvironment _env;

    public PdfController(IWebHostEnvironment env) => _env = env;

    [HttpGet("ViewFile")]
    public IActionResult ViewFile(string fileName)
    {
        // Build the full path to the PDF on disk
        string path = Path.Combine(_env.WebRootPath, "pdfs", fileName);

        // Load the existing PDF document
        var pdf = PdfDocument.FromFile(path);

        // Read the binary content from the PDF stream
        byte[] bytes = pdf.Stream.ToArray();

        // Serve inline so the browser displays it directly
        Response.Headers.Append("Content-Disposition", $"inline; filename={fileName}");
        Response.Headers.Append("Content-Length", bytes.Length.ToString());

        return File(bytes, "application/pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]")]
public class PdfController : Controller
{
    private readonly IWebHostEnvironment _env;

    public PdfController(IWebHostEnvironment env) => _env = env;

    [HttpGet("ViewFile")]
    public IActionResult ViewFile(string fileName)
    {
        // Build the full path to the PDF on disk
        string path = Path.Combine(_env.WebRootPath, "pdfs", fileName);

        // Load the existing PDF document
        var pdf = PdfDocument.FromFile(path);

        // Read the binary content from the PDF stream
        byte[] bytes = pdf.Stream.ToArray();

        // Serve inline so the browser displays it directly
        Response.Headers.Append("Content-Disposition", $"inline; filename={fileName}");
        Response.Headers.Append("Content-Length", bytes.Length.ToString());

        return File(bytes, "application/pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

<Route("[controller]")>
Public Class PdfController
    Inherits Controller

    Private ReadOnly _env As IWebHostEnvironment

    Public Sub New(env As IWebHostEnvironment)
        _env = env
    End Sub

    <HttpGet("ViewFile")>
    Public Function ViewFile(fileName As String) As IActionResult
        ' Build the full path to the PDF on disk
        Dim path As String = Path.Combine(_env.WebRootPath, "pdfs", fileName)

        ' Load the existing PDF document
        Dim pdf = PdfDocument.FromFile(path)

        ' Read the binary content from the PDF stream
        Dim bytes As Byte() = pdf.Stream.ToArray()

        ' Serve inline so the browser displays it directly
        Response.Headers.Append("Content-Disposition", $"inline; filename={fileName}")
        Response.Headers.Append("Content-Length", bytes.Length.ToString())

        Return File(bytes, "application/pdf")
    End Function
End Class

既存の PDF を開くとどのようになりますか?

データベースからの PDF をどのように操作しますか?

データベースから取得したバイト配列を操作するには、ドキュメントを提供する前に正しく読み込むための慎重な処理が必要です。

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]")]
public class PdfController : Controller
{
    [HttpGet("DisplayFromDatabase/{documentId:int}")]
    public IActionResult DisplayFromDatabase(int documentId)
    {
        // Retrieve the stored byte array from the database
        byte[] pdfData = GetPdfFromDatabase(documentId);

        // Load into an IronPDF document object for optional manipulation
        var pdf = PdfDocument.FromBytes(pdfData);

        // Set response headers for inline browser display
        Response.Headers.Append(
            "Content-Disposition",
            $"inline; filename=document_{documentId}.pdf");
        Response.Headers.Append("Content-Length", pdfData.Length.ToString());

        return File(pdfData, "application/pdf");
    }

    private static byte[] GetPdfFromDatabase(int documentId)
    {
        // Replace with actual database retrieval logic
        return Array.Empty<byte>();
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]")]
public class PdfController : Controller
{
    [HttpGet("DisplayFromDatabase/{documentId:int}")]
    public IActionResult DisplayFromDatabase(int documentId)
    {
        // Retrieve the stored byte array from the database
        byte[] pdfData = GetPdfFromDatabase(documentId);

        // Load into an IronPDF document object for optional manipulation
        var pdf = PdfDocument.FromBytes(pdfData);

        // Set response headers for inline browser display
        Response.Headers.Append(
            "Content-Disposition",
            $"inline; filename=document_{documentId}.pdf");
        Response.Headers.Append("Content-Length", pdfData.Length.ToString());

        return File(pdfData, "application/pdf");
    }

    private static byte[] GetPdfFromDatabase(int documentId)
    {
        // Replace with actual database retrieval logic
        return Array.Empty<byte>();
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

<Route("[controller]")>
Public Class PdfController
    Inherits Controller

    <HttpGet("DisplayFromDatabase/{documentId:int}")>
    Public Function DisplayFromDatabase(documentId As Integer) As IActionResult
        ' Retrieve the stored byte array from the database
        Dim pdfData As Byte() = GetPdfFromDatabase(documentId)

        ' Load into an IronPDF document object for optional manipulation
        Dim pdf = PdfDocument.FromBytes(pdfData)

        ' Set response headers for inline browser display
        Response.Headers.Append("Content-Disposition", $"inline; filename=document_{documentId}.pdf")
        Response.Headers.Append("Content-Length", pdfData.Length.ToString())

        Return File(pdfData, "application/pdf")
    End Function

    Private Shared Function GetPdfFromDatabase(documentId As Integer) As Byte()
        ' Replace with actual database retrieval logic
        Return Array.Empty(Of Byte)()
    End Function
End Class

どのレンダリング オプションをカスタマイズできますか?

IronPDF は、CSS スタイル、画像、Web フォントを含む高度な HTML から PDF への変換をサポートします。 このライブラリは、実稼働環境でピクセルパーフェクトな結果を実現するためのトラブルシューティング ガイドも提供します。

以下の表は、主な提供戦略と、それぞれの戦略を使用するタイミングをまとめたものです。