ASP.NET C# 및 IronPDF를 사용하여 새 창에 PDF 열기

PDF 디스플레이 문제에 대해 왜 신경 쓸 필요가 있습니까?

ASP.NET을 통해 PDF 파일을 제공할 때 기본 동작은 브라우저 표시보다는 다운로드로 이어집니다. 이는 서버가 HTTP 응답 헤더를 통해 파일을 브라우저에 전송하는 방식 때문입니다. 콘텐츠 배포 헤더는 PDF 파일이 인라인으로 열릴지 다운로드될지를 제어합니다.

전통적인 ASP.NET 코드는 Response.BinaryWrite와 바이트 배열을 사용하여 다운로드를 트리거하는 헤더를 자주 설정합니다. 개발자가 Response.ContentType = "application/pdf"을 설정했을 때조차, 누락되었거나 잘못된 Content-Disposition 값으로 인해 브라우저가 PDF 문서를 표시하기보다는 다운로드하게 만듭니다. 다양한 브라우저도 PDF 파일을 일관성 없이 처리합니다 -- 일부 데스크톱 브라우저는 기본적으로 파일을 인라인으로 표시하는 반면, 모바일 브라우저는 종종 다운로드하는 것을 기본값으로 설정합니다.

이러한 문제가 가장 자주 발생하는 시기는 언제입니까?

HTML 문자열 또는 데이터베이스 소스에서 동적으로 생성된 PDF 문서로 작업할 때 서버 측 구성은 더 복잡해집니다. 올바른 경로와 적절한 헤더가 없으면 일관된 크로스 브라우저 디스플레이를 달성하는 것은 실제로 어렵습니다. 많은 개발자들이 이 지속적인 문제의 해결책을 찾기 위해 Stack Overflow를 찾습니다. Content-Disposition에 대한 MDN 웹 문서 항목은 인라인 및 첨부 값 모두에 대한 정확한 구문 및 브라우저 동작을 이해하기 위한 권위 있는 참조 자료입니다.

IronPDF의 접근 방식이 다른 점은 무엇입니까?

라이브러리의 ChromePdfRenderer 클래스는 PDF 생성에 대한 현대적인 접근 방식을 제공합니다. 바이트 배열과 응답 스트림을 수동으로 관리하는 대신, 개발자들은 HTML 문자열, HTML 파일 또는 URL에서 간단한 메소드 호출로 PDF를 생성할 수 있습니다. IronPDF는 렌더링 과정을 내부적으로 처리하여 다양한 환경에서 일관된 출력을 보장합니다.

어떤 기능이 가장 도움이 됩니까?

기본적인 생성 외에도, IronPDF는 출력 사용자화를 위한 다양한 렌더링 옵션을 제공하여 종이 크기, 여백 및 JavaScript 실행 지연을 포함합니다. 이 유연성 덕분에 간단한 문서부터 차트 및 동적 콘텐츠가 포함된 복잡한 보고서에 이르기까지 모든 것을 만드는 데 적합합니다.

렌더링 엔진은 또한 사용자 정의 헤더 및 푸터, 워터마크 및 페이지 번호 매기기를 지원하며, 모두 렌더 메소드를 호출하기 전에 간단한 옵션 개체를 통해 구성됩니다. 기존 브랜드 스타일 가이드를 맞출 필요가 있는 개발자에게는 이 수준의 출력 형식 제어가 PDF 바이너리 데이터를 수동으로 생성하는 것보다 큰 장점입니다.

생성된 PDF 파일은 어떤 모습인가요?

위의 코드는 [HttpGet]을 사용합니다. 사용자가 양식을 제출한 후 PDF를 생성할 때는 [HttpPost] 속성을 대신 사용하십시오. 이 구별이 중요한 이유는 GET 요청은 멱등적이어야 하고, POST 요청은 개인화된 문서를 생성하는 데 사용되는 제출된 양식 데이터를 포함하기 때문입니다.

Response.Headers.Append이 Response.Headers.Add 대신 사용된 것을 주목하십시오. ASP.NET Core에서는 응답 헤더를 추가하기 위한 선호되는 API 방식이 Append 메서드입니다. 이 방법은 헤더가 이미 존재하는 경우 예외를 던지지 않습니다. Add을 사용하면 헤더가 이미 부분적으로 설정된 미들웨어 파이프라인에서 예외가 발생할 수 있습니다.

왜 Content-Disposition 헤더가 중요합니까?

브라우저에서 PDF 파일을 열기 위한 중요한 세부사항은 Content-Disposition 헤더를 "inline"로 설정하는 것이며, 이는 "attachment" 대신입니다. "attachment" 값은 브라우저에 파일을 다운로드하여 디스크에 저장하라고 지시합니다. 이것을 "inline"로 설정하면 브라우저가 파일을 브라우저 창 내에서 표시하려고 시도합니다. 이는 현대적인 브라우저가 네이티브 PDF 렌더링을 지원할 경우 자동으로 수행합니다.

이를 WebForms에 어떻게 구현합니까?

WebForms 애플리케이션에서는 PDF를 HTTP 응답을 통해 직접 제공하고 버튼 클릭 이벤트에서 브라우저 디스플레이를 트리거할 수 있습니다:

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
}

ASP.NET 컨트롤과 JavaScript를 어떻게 결합합니까?

ASP.NET WebForms 애플리케이션에서는 JavaScript 호출을 OnClientClick 속성을 사용하여 버튼 컨트롤에 직접 연결하십시오:

<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" 동작을 반영합니다.

문서를 페이지에 직접 임베딩하는 방법은 무엇입니까?

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 스타일링, 이미지 및 웹 글꼴을 포함한 고급 HTML to PDF 변환을 지원합니다. 또한 라이브러리는 프로덕션 환경에서 픽셀 완벽한 결과를 얻기 위한 문제 해결 가이드를 제공합니다.

아래 표는 주요 제공 전략과 각 사용 시기를 요약합니다: