Xamarin PDFジェネレーターを作成する方法

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

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

ASP.NET の伝統的なコードは Response.BinaryWrite を使用して バイト配列 を適用し、しばしばダウンロードを触発するヘッダーを設定します。 開発者が 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 では、レスポンスヘッダーを追加するための推奨 API は Append メソッドです。これは、ヘッダーが既に存在する場合でもエラーをスローしません。 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() を使用すると、第二引数 '_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 への変換をサポートします。 このライブラリは、実稼働環境でピクセルパーフェクトな結果を実現するためのトラブルシューティング ガイドも提供します。

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