Chrome PDF 렌더링 엔진 (C#으로 구현)

IronPDF의 크롬 렌더링 엔진의 주요 이점은 무엇입니까?

IronPDF는 어떻게 설치하나요?

먼저 NuGet 패키지 관리자를 사용하여 IronPDF를 프로젝트에 설치하세요. 설치 과정은 간단하며 개발 환경에 따라 다양한 방법으로 완료할 수 있습니다.

# Using Package Manager Console
Install-Package IronPdf

# Using .NET CLI
dotnet add package IronPdf

# Using PackageReference in your .csproj file
<PackageReference Include="IronPdf" Version="*" />

# Using Package Manager Console
Install-Package IronPdf

# Using .NET CLI
dotnet add package IronPdf

# Using PackageReference in your .csproj file
<PackageReference Include="IronPdf" Version="*" />

설치 후 C# 파일 맨 위에 적절한 using 문을 추가하세요.

using IronPdf;

using IronPdf;

Azure 배포 또는 Docker 컨테이너에서 실행 과 같은 고급 설치 시나리오에 대해서는 자세한 설치 가이드를 참조하십시오.

새 API는 어떻게 사용하나요?

기존에 사용 중인 IronPDF C# 및 VB.NET API는 그대로 유지되었습니다. 그대로 남을 겁니다! 하지만 기존 방식은 사용자에게 더 많은 제어 권한을 제공하는 더 나은 방식으로 대체되고 있습니다. 새로운 API는 향상된 구성 옵션을 통해 더욱 직관적이고 유연한 PDF 생성 방식을 제공합니다.

using IronPdf;

// Create a renderer with custom options
var renderer = new ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.CssMediaType.Screen;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Set paper size and margins
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

// Set HTTP credentials if needed for protected resources
renderer.RenderingOptions.HttpLoginCredentials = new IronPdf.HttpLoginCredentials()
{
    Username = "yourUsername",
    Password = "yourPassword"
};

// Render HTML to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Professional Document</h1><p>Generated with IronPDF</p>");
pdf.SaveAs("ProfessionalDocument.pdf");

using IronPdf;

// Create a renderer with custom options
var renderer = new ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.CssMediaType.Screen;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Set paper size and margins
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

// Set HTTP credentials if needed for protected resources
renderer.RenderingOptions.HttpLoginCredentials = new IronPdf.HttpLoginCredentials()
{
    Username = "yourUsername",
    Password = "yourPassword"
};

// Render HTML to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Professional Document</h1><p>Generated with IronPDF</p>");
pdf.SaveAs("ProfessionalDocument.pdf");

렌더링 옵션 에 대한 자세한 내용은 상세 문서를 참조하십시오.

크롬에서 픽셀 단위로 정확한 렌더링을 적용하는 방법은 무엇인가요?

이 예제를 통해 최신 크롬 데스크톱 브라우저의 "PDF로 인쇄" 기능과 픽셀 단위까지 완벽하게 일치하는 PDF 파일을 생성할 수 있습니다. 크롬 렌더링 엔진은 복잡한 CSS 레이아웃과 자바스크립트로 렌더링된 요소를 포함한 HTML 콘텐츠가 크롬 브라우저 창에서 보이는 것과 정확히 동일하게 표시되도록 합니다.

using IronPdf;
using System.IO;

// Create a Chrome PDF renderer
var renderer = new ChromePdfRenderer();

// Configure for pixel-perfect rendering
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.CssMediaType.Print;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.RenderDelay = 500; // Wait for JavaScript to execute

// Load HTML from file
string htmlContent = File.ReadAllText("template.html");

// Include base URL for relative assets
renderer.RenderingOptions.BaseUrl = new Uri("file:///C:/your-project/assets/").AbsoluteUri;

// Render the HTML to PDF
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Title = "Pixel-Perfect Document";
pdf.MetaData.CreationDate = DateTime.Now;

// Save the PDF
pdf.SaveAs("PixelPerfect.pdf");

using IronPdf;
using System.IO;

// Create a Chrome PDF renderer
var renderer = new ChromePdfRenderer();

// Configure for pixel-perfect rendering
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.CssMediaType.Print;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.RenderDelay = 500; // Wait for JavaScript to execute

// Load HTML from file
string htmlContent = File.ReadAllText("template.html");

// Include base URL for relative assets
renderer.RenderingOptions.BaseUrl = new Uri("file:///C:/your-project/assets/").AbsoluteUri;

// Render the HTML to PDF
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Title = "Pixel-Perfect Document";
pdf.MetaData.CreationDate = DateTime.Now;

// Save the PDF
pdf.SaveAs("PixelPerfect.pdf");

완벽한 렌더링을 위해서는 Chrome에서 HTML 디버깅하는 방법 에 대한 가이드를 참고하시기 바랍니다.

using IronPdf;

// Example showing recommended improvements such as responsive layout
var renderer = new ChromePdfRenderer();

// Enable responsive CSS
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.CssMediaType.Screen;
renderer.RenderingOptions.ViewPortWidth = 1024;

// Enable form creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Add custom header
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    Height = 25,
    HtmlFragment = "<div style='text-align: center; font-size: 12px;'>Company Name - Confidential</div>",
    DrawDividerLine = true
};

// Add custom footer with page numbers
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    Height = 25,
    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>",
    DrawDividerLine = true
};

// Render HTML with form elements
string formHtml = @"
<html>
<body>
    <h1>Application Form</h1>
    <form>
        <label>Name: <input type='text' name='name' /></label><br/>
        <label>Email: <input type='email' name='email' /></label><br/>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br/>
        <button type='submit'>Submit</button>
    </form>
</body>
</html>";

var pdf = renderer.RenderHtmlAsPdf(formHtml);
pdf.SaveAs("FormDocument.pdf");

using IronPdf;

// Example showing recommended improvements such as responsive layout
var renderer = new ChromePdfRenderer();

// Enable responsive CSS
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.CssMediaType.Screen;
renderer.RenderingOptions.ViewPortWidth = 1024;

// Enable form creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Add custom header
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    Height = 25,
    HtmlFragment = "<div style='text-align: center; font-size: 12px;'>Company Name - Confidential</div>",
    DrawDividerLine = true
};

// Add custom footer with page numbers
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    Height = 25,
    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>",
    DrawDividerLine = true
};

// Render HTML with form elements
string formHtml = @"
<html>
<body>
    <h1>Application Form</h1>
    <form>
        <label>Name: <input type='text' name='name' /></label><br/>
        <label>Email: <input type='email' name='email' /></label><br/>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br/>
        <button type='submit'>Submit</button>
    </form>
</body>
</html>";

var pdf = renderer.RenderHtmlAsPdf(formHtml);
pdf.SaveAs("FormDocument.pdf");

멀티스레딩 및 비동기 지원을 어떻게 구현하나요?

크롬 렌더링 엔진의 멀티스레딩 및 비동기 지원으로 이전 빌드보다 뛰어난 성능을 제공합니다. 새로운 엔진은 동시 작업을 효율적으로 처리하도록 처음부터 설계되어 고처리량 애플리케이션 및 웹 서비스에 이상적입니다.

• 기업 수준의 멀티스레딩을 사용하려면 기존 스레드에 ChromePdfRenderer를 사용하면 작동합니다. 웹 애플리케이션의 경우, 별도의 설정이 필요하지 않습니다.
• HTML을 PDF로 일괄 처리하려면 .NET의 내장 Parallel.ForEach 패턴을 사용하십시오.
• 저희는 ChromePdfRenderer.RenderHtmlAsPdfAsync와 같은 모든 렌더링 메서드의 비동기 버전을 제공합니다.

최적의 성능을 위한 비동기 및 멀티스레딩 기술 에 대해 자세히 알아보세요.

using IronPdf;
using System.Threading.Tasks;
using System.Collections.Generic;
using System.Linq;

// Example of using async rendering for a single document
public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdfDocument = await renderer.RenderHtmlAsPdfAsync(html);
    return pdfDocument.BinaryData;
}

// Example of batch processing with parallel execution
public async Task GenerateMultiplePdfsAsync(List<string> htmlDocuments)
{
    var renderer = new ChromePdfRenderer();

    // Process multiple documents in parallel
    var tasks = htmlDocuments.Select(async (html, index) =>
    {
        var pdf = await renderer.RenderHtmlAsPdfAsync(html);
        await pdf.SaveAsAsync($"Document_{index}.pdf");
    });

    await Task.WhenAll(tasks);
}

// Example using Parallel.ForEach for CPU-intensive batch processing
public void GeneratePdfsBatch(List<string> urls)
{
    Parallel.ForEach(urls, new ParallelOptions { MaxDegreeOfParallelism = 4 }, url =>
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs($"{Path.GetFileNameWithoutExtension(url)}.pdf");
    });
}

using IronPdf;
using System.Threading.Tasks;
using System.Collections.Generic;
using System.Linq;

// Example of using async rendering for a single document
public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdfDocument = await renderer.RenderHtmlAsPdfAsync(html);
    return pdfDocument.BinaryData;
}

// Example of batch processing with parallel execution
public async Task GenerateMultiplePdfsAsync(List<string> htmlDocuments)
{
    var renderer = new ChromePdfRenderer();

    // Process multiple documents in parallel
    var tasks = htmlDocuments.Select(async (html, index) =>
    {
        var pdf = await renderer.RenderHtmlAsPdfAsync(html);
        await pdf.SaveAsAsync($"Document_{index}.pdf");
    });

    await Task.WhenAll(tasks);
}

// Example using Parallel.ForEach for CPU-intensive batch processing
public void GeneratePdfsBatch(List<string> urls)
{
    Parallel.ForEach(urls, new ParallelOptions { MaxDegreeOfParallelism = 4 }, url =>
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs($"{Path.GetFileNameWithoutExtension(url)}.pdf");
    });
}

다음 단계는 무엇일까요?