C#によるChrome PDFレンダリングエンジン

IronPDFのChromeレンダリングエンジンの主な利点は何ですか?

どのように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");

レンダリング オプションの詳細については、詳細なドキュメントを参照してください。

ピクセル パーフェクトな Chrome レンダリングを適用するにはどうすればよいですか?

この例では、最新のChromeデスクトップブラウザの"PDFに印刷"機能にピクセルパーフェクトなPDFを提供します。 Chromeのレンダリングエンジンにより、複雑なCSSレイアウトやJavaScriptでレンダリングされた要素を含むHTMLコンテンツが、Chromeブラウザのウィンドウに表示されるのとまったく同じように表示されます。

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");

マルチスレッドと非同期サポートを実装するにはどうすればよいですか?

Chromeレンダリングエンジンのマルチスレッドおよび非同期サポートは、以前のビルドと比較して優れたパフォーマンスを提供します。 この新しいエンジンは、並行処理を効率的に処理できるように一から設計されており、高スループットのアプリケーションやウェブサービスに最適です。

• エンタープライズ グレードのマルチスレッドの場合、既存のスレッドで ChromePdfRenderer を使用すると機能します。 ウェブアプリケーションの場合、セットアップは不要です。
• HTML から PDF へのバッチ処理には、組み込み for .NET Parallel.ForEach パターンを使用します。
• ChromePdfRenderer.RenderHtmlAsPdfAsync など、すべてのレンダリング メソッドの非同期バリアントを提供します。

パフォーマンスを最適化するためのasyncとマルチスレッド技術の詳細については、こちらをご覧ください。

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");
    });
}

次は何ですか?