C# PDFライブラリ

HTML から PDF へ

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

ビデオ

How to Create a PDF Viewer and Generator in Blazor | IronPDF

Curtis Chau

Updated: 2026年7月19日

Telerik Reportingは強力なエンタープライズレポートプラットフォームであり、ビジュアルデザイナーとドリルダウン機能を備えたインタラクティブなレポートを構築するために、.NET開発者に役立ってきました。しかし、Telerik Reportingは、包括的なレポーティングインフラストラクチャではなく、PDF生成が主なニーズであるチームにとって、ライセンスコスト、デプロイの複雑さ、ランタイムのフットプリントなどの大きなオーバーヘッドになることがよくあります。

このガイドでは、Telerik ReportingからIronPDFへの完全な移行経路を、移行を検討している.NET開発者のために、ステップバイステップの手順、コード比較、実用的な例とともに提供します。

なぜTelerik レポートから移行するのですか?

Telerik Reportingからの移行の決定は、通常、ツールを実際の要件に適合させることを中心に行われます。開発チームが移行を検討する主な理由は次のとおりです：

開発者あたりのライセンス： スタンドアロンのTelerik Reportingは、1人の開発者あたり約$685から始まり、より広範なDevCraft Completeバンドルは約$1,763から始まります（2026年Q1、ComponentSource）。どちらも、永久 + 1年のメンテナンスまたは年間サブスクリプションとして販売されます。 PDFの生成だけが必要なチームにとって、これは未使用の重要な機能です。

レポートデザイナーの依存関係: Telerik Reportingには、スタンドアロン、Web、またはVisual Studio統合デザイナーとプライベートTelerik NuGetフィードから取得したランタイムアセンブリが必要です（https://nuget.telerik.com/v3/index.json、ライセンスキーが必要です）。このため、開発環境やCI/CDパイプラインが複雑になります。

複雑なインフラストラクチャ: HTML5ビューワーのシナリオでは、ストレージ、リゾルバ、ビューワースクリプト構成を備えたReporting RESTサービス（Telerik.Reporting.Services.AspNetCore）もホストします。これは、簡単なPDF生成タスクに対して保守の負担を増すインフラストラクチャです。

独自形式: .trdp と .trdx XMLレポート定義（Telerik独自の形式 - RDL/RDLCは明示的にサポートされていません）は、Telerikエコシステムにロックされます。テンプレートの移行や修正には、Telerikのツールが必要です。

重い運用： 単純なHTMLからのPDF変換であるにもかかわらず、大規模な展開フットプリント、さらにDOCX/XLSX/PPTX/XPSのレンダリングDLLがオプションです。

更新可能なメンテナンス： 永久ライセンスでも、継続的な更新、修正、サポートにはメンテナンスサブスクリプションの更新が必要です。

Telerikレポートが過剰な場合

Telerik Reportingを主にデータからPDFを生成するために使用している場合、未使用の機能に対して料金を支払っている可能性が高いです：

必要なもの	Telerikの提供（未使用）
HTMLからPDFへ	ビジュアルデザイナー、ドリルダウン
簡単なレポート	インタラクティブなビューア、エクスポート
サーバーサイドPDF	デスクトップコントロール、チャートエンジン

IronPDFはエンタープライズレポートオーバーヘッドのないPDF生成を提供します。

IronPDFとTelerik Reportingの比較：機能比較

アーキテクチャの違いを理解することは、技術的な意思決定者が移行への投資を評価するのに役立ちます：

フィーチャー	Telerik レポート	IronPDF
フォーカス	PDFエクスポートオプション付きレポート作成	HTMLからの包括的なPDF生成
統合。	.NET Coreアプリケーションとのシームレスな連携	あらゆる.NETアプリケーションに統合可能
セットアップの複雑さ	レポートデザイナーのインストールが必要	簡単なNuGetインストール
価格について	DevCraft商用スイートの一部	別ライセンス、スタンドアロンPDF生成のためのより高い費用対効果
PDFジェネレーション。	レポートのエクスポートに限定	高度なPDF操作のフル機能
対象読者	レポート中心のソリューションを必要とする開発者	柔軟なPDF生成ソリューションを必要とする開発者
テンプレート形式	`.trdp` / `.trdx` (XML; RDL/RDLCではありません)	HTML/CSS/Razor
ラーニングカーブ	Telerik固有の (表現言語、セクション)	標準的なウェブ技術
HTMLからPDFへ	サーバーサイドで `HtmlTextBox` （限られたHTML/CSS）による	完全なChromiumレンダリング
URLからPDFへ。	組み込みではありません (HTMLを自分で取得する)	はい
CSSサポート	制限されている (デザイナーのCSS風のセレクター)	完全なCSS3
レンダリング時 for JavaScript	いいえ (サーバーエンジンはJSを実行しません)	フルES2024
デジタル署名。	はい (X.509 / .PFX経由PDFデバイス情報)	はい
PDF/A	PDF/A-1b, PDF/A-2b, PDF/A-3b	PDF/A-3
ランタイムサイズ	大きい (エンジン + 各形式のレンダリングDLL)	小規模

クイックスタートTelerik ReportingからIronPDFへの移行

これらの基本的なステップを踏めば、すぐにでも移行を開始できます。

ステップ 1: NuGet パッケージを置き換える

Telerik Reportingパッケージをすべて削除してください：

# RemoveTelerik レポートpackages (hosted on the private Telerik NuGet feed)
dotnet remove package Telerik.Reporting
dotnet remove package Telerik.Reporting.Services.AspNetCore
dotnet remove package Telerik.ReportViewer.Mvc

# RemoveTelerik レポートpackages (hosted on the private Telerik NuGet feed)
dotnet remove package Telerik.Reporting
dotnet remove package Telerik.Reporting.Services.AspNetCore
dotnet remove package Telerik.ReportViewer.Mvc

SHELL

IronPDFをインストールします：

# InstallIronPDF(hosted on nuget.org)
dotnet add package IronPdf

# InstallIronPDF(hosted on nuget.org)
dotnet add package IronPdf

SHELL

ステップ 2: 名前空間の更新

Telerikの名前空間をIronPDFの名前空間に置き換えます。

// Before (Telerik Reporting)
using Telerik.Reporting;
using Telerik.Reporting.Processing;
using Telerik.Reporting.Drawing;

// After (IronPDF)
using IronPdf;

// Before (Telerik Reporting)
using Telerik.Reporting;
using Telerik.Reporting.Processing;
using Telerik.Reporting.Drawing;

// After (IronPDF)
using IronPdf;

Imports Telerik.Reporting
Imports Telerik.Reporting.Processing
Imports Telerik.Reporting.Drawing

' After (IronPDF)
Imports IronPdf

Imports Telerik.Reporting
Imports Telerik.Reporting.Processing
Imports Telerik.Reporting.Drawing

' After (IronPDF)
Imports IronPdf

ステップ 3: ライセンスの初期化

アプリケーション起動時のライセンス初期化を追加します：

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

コード移行の例

HTML を PDF に変換する

最も一般的な使用例は、これら for .NET PDFライブラリのアーキテクチャの違いを示しています。

Telerik レポートアプローチ:

// NuGet: Install-Package Telerik.Reporting
using Telerik.Reporting;
using Telerik.Reporting.Processing;
using System.Collections.Specialized;

class TelerikExample
{
    static void Main()
    {
        var reportSource = new Telerik.Reporting.TypeReportSource();
        var instanceReportSource = new Telerik.Reporting.InstanceReportSource();
        instanceReportSource.ReportDocument = new Telerik.Reporting.Report()
        {
            Items = { new Telerik.Reporting.HtmlTextBox() { Value = "<h1>Hello World</h1><p>Sample HTML content</p>" } }
        };
        
        var reportProcessor = new ReportProcessor();
        var result = reportProcessor.RenderReport("PDF", instanceReportSource, null);
        
        using (var fs = new System.IO.FileStream("output.pdf", System.IO.FileMode.Create))
        {
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length);
        }
    }
}

// NuGet: Install-Package Telerik.Reporting
using Telerik.Reporting;
using Telerik.Reporting.Processing;
using System.Collections.Specialized;

class TelerikExample
{
    static void Main()
    {
        var reportSource = new Telerik.Reporting.TypeReportSource();
        var instanceReportSource = new Telerik.Reporting.InstanceReportSource();
        instanceReportSource.ReportDocument = new Telerik.Reporting.Report()
        {
            Items = { new Telerik.Reporting.HtmlTextBox() { Value = "<h1>Hello World</h1><p>Sample HTML content</p>" } }
        };
        
        var reportProcessor = new ReportProcessor();
        var result = reportProcessor.RenderReport("PDF", instanceReportSource, null);
        
        using (var fs = new System.IO.FileStream("output.pdf", System.IO.FileMode.Create))
        {
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length);
        }
    }
}

' NuGet: Install-Package Telerik.Reporting
Imports Telerik.Reporting
Imports Telerik.Reporting.Processing
Imports System.Collections.Specialized

Class TelerikExample
    Shared Sub Main()
        Dim reportSource As New Telerik.Reporting.TypeReportSource()
        Dim instanceReportSource As New Telerik.Reporting.InstanceReportSource()
        instanceReportSource.ReportDocument = New Telerik.Reporting.Report() With {
            .Items = {New Telerik.Reporting.HtmlTextBox() With {.Value = "<h1>Hello World</h1><p>Sample HTML content</p>"}}
        }

        Dim reportProcessor As New ReportProcessor()
        Dim result = reportProcessor.RenderReport("PDF", instanceReportSource, Nothing)

        Using fs As New System.IO.FileStream("output.pdf", System.IO.FileMode.Create)
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length)
        End Using
    End Sub
End Class

' NuGet: Install-Package Telerik.Reporting
Imports Telerik.Reporting
Imports Telerik.Reporting.Processing
Imports System.Collections.Specialized

Class TelerikExample
    Shared Sub Main()
        Dim reportSource As New Telerik.Reporting.TypeReportSource()
        Dim instanceReportSource As New Telerik.Reporting.InstanceReportSource()
        instanceReportSource.ReportDocument = New Telerik.Reporting.Report() With {
            .Items = {New Telerik.Reporting.HtmlTextBox() With {.Value = "<h1>Hello World</h1><p>Sample HTML content</p>"}}
        }

        Dim reportProcessor As New ReportProcessor()
        Dim result = reportProcessor.RenderReport("PDF", instanceReportSource, Nothing)

        Using fs As New System.IO.FileStream("output.pdf", System.IO.FileMode.Create)
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length)
        End Using
    End Sub
End Class

IronPDFのアプローチ:

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>Sample HTML content</p>");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>Sample HTML content</p>");
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf
Imports System

Class IronPdfExample
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>Sample HTML content</p>")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Imports IronPdf
Imports System

Class IronPdfExample
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>Sample HTML content</p>")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Telerikバージョンでは、Report オブジェクトをReportProcessorとともに作成し、手動でファイルストリーム管理が必要です。 IronPDFのChromePdfRendererは、コード3行で全体のプロセスを処理します。

高度なHTMLからPDFへのシナリオについては、HTMLからPDFへの変換ガイドをご覧ください。

URLをPDFに変換する

URLからPDFへの変換は、Telerik Reportingの重要な機能ギャップを明らかにします。

Telerik レポートアプローチ:

// NuGet: Install-Package Telerik.Reporting
using Telerik.Reporting;
using Telerik.Reporting.Processing;
using System.Net;

class TelerikExample
{
    static void Main()
    {
        string htmlContent;
        using (var client = new WebClient())
        {
            htmlContent = client.DownloadString("https://example.com");
        }
        
        var report = new Telerik.Reporting.Report();
        var htmlTextBox = new Telerik.Reporting.HtmlTextBox()
        {
            Value = htmlContent
        };
        report.Items.Add(htmlTextBox);
        
        var instanceReportSource = new Telerik.Reporting.InstanceReportSource();
        instanceReportSource.ReportDocument = report;
        
        var reportProcessor = new ReportProcessor();
        var result = reportProcessor.RenderReport("PDF", instanceReportSource, null);
        
        using (var fs = new System.IO.FileStream("webpage.pdf", System.IO.FileMode.Create))
        {
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length);
        }
    }
}

// NuGet: Install-Package Telerik.Reporting
using Telerik.Reporting;
using Telerik.Reporting.Processing;
using System.Net;

class TelerikExample
{
    static void Main()
    {
        string htmlContent;
        using (var client = new WebClient())
        {
            htmlContent = client.DownloadString("https://example.com");
        }
        
        var report = new Telerik.Reporting.Report();
        var htmlTextBox = new Telerik.Reporting.HtmlTextBox()
        {
            Value = htmlContent
        };
        report.Items.Add(htmlTextBox);
        
        var instanceReportSource = new Telerik.Reporting.InstanceReportSource();
        instanceReportSource.ReportDocument = report;
        
        var reportProcessor = new ReportProcessor();
        var result = reportProcessor.RenderReport("PDF", instanceReportSource, null);
        
        using (var fs = new System.IO.FileStream("webpage.pdf", System.IO.FileMode.Create))
        {
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length);
        }
    }
}

' NuGet: Install-Package Telerik.Reporting
Imports Telerik.Reporting
Imports Telerik.Reporting.Processing
Imports System.Net

Class TelerikExample
    Shared Sub Main()
        Dim htmlContent As String
        Using client As New WebClient()
            htmlContent = client.DownloadString("https://example.com")
        End Using
        
        Dim report As New Telerik.Reporting.Report()
        Dim htmlTextBox As New Telerik.Reporting.HtmlTextBox() With {
            .Value = htmlContent
        }
        report.Items.Add(htmlTextBox)
        
        Dim instanceReportSource As New Telerik.Reporting.InstanceReportSource()
        instanceReportSource.ReportDocument = report
        
        Dim reportProcessor As New ReportProcessor()
        Dim result = reportProcessor.RenderReport("PDF", instanceReportSource, Nothing)
        
        Using fs As New System.IO.FileStream("webpage.pdf", System.IO.FileMode.Create)
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length)
        End Using
    End Sub
End Class

' NuGet: Install-Package Telerik.Reporting
Imports Telerik.Reporting
Imports Telerik.Reporting.Processing
Imports System.Net

Class TelerikExample
    Shared Sub Main()
        Dim htmlContent As String
        Using client As New WebClient()
            htmlContent = client.DownloadString("https://example.com")
        End Using
        
        Dim report As New Telerik.Reporting.Report()
        Dim htmlTextBox As New Telerik.Reporting.HtmlTextBox() With {
            .Value = htmlContent
        }
        report.Items.Add(htmlTextBox)
        
        Dim instanceReportSource As New Telerik.Reporting.InstanceReportSource()
        instanceReportSource.ReportDocument = report
        
        Dim reportProcessor As New ReportProcessor()
        Dim result = reportProcessor.RenderReport("PDF", instanceReportSource, Nothing)
        
        Using fs As New System.IO.FileStream("webpage.pdf", System.IO.FileMode.Create)
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length)
        End Using
    End Sub
End Class

IronPDFのアプローチ:

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

Imports IronPdf
Imports System

Class IronPdfExample
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SaveAs("webpage.pdf")
    End Sub
End Class

Imports IronPdf
Imports System

Class IronPdfExample
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SaveAs("webpage.pdf")
    End Sub
End Class

Telerik Reportingには組み込みのURLからPDFへのメソッドがなく、（ここではWebClientを経由して）HTMLを自分で取得します。サーバーサイドエンジンはJavaScriptを実行しないため、外部スクリプトや動的コンテンツはレンダリングされません。 IronPDFのRenderUrlAsPdfメソッドは、ブラウザで表示されるままの完全にレンダリングされたページをキャプチャします。

認証とカスタムヘッダーオプションについては、URL to PDF documentationを参照してください。

ヘッダーとフッターをページ番号で実装する

プロフェッショナルな文書には、動的なページ番号を持つヘッダーとフッターが不可欠です。実装アプローチは大きく異なります。

Telerik レポートアプローチ:

// NuGet: Install-Package Telerik.Reporting
using Telerik.Reporting;
using Telerik.Reporting.Processing;
using Telerik.Reporting.Drawing;

class TelerikExample
{
    static void Main()
    {
        var report = new Telerik.Reporting.Report();
        
        // Add page header
        var pageHeader = new Telerik.Reporting.PageHeaderSection();
        pageHeader.Height = new Unit(0.5, UnitType.Inch);
        pageHeader.Items.Add(new Telerik.Reporting.TextBox()
        {
            Value = "Document Header",
            Location = new PointU(0, 0),
            Size = new SizeU(new Unit(6, UnitType.Inch), new Unit(0.3, UnitType.Inch))
        });
        report.PageHeaderSection = pageHeader;
        
        // Add page footer
        var pageFooter = new Telerik.Reporting.PageFooterSection();
        pageFooter.Height = new Unit(0.5, UnitType.Inch);
        pageFooter.Items.Add(new Telerik.Reporting.TextBox()
        {
            Value = "Page {PageNumber} of {PageCount}",
            Location = new PointU(0, 0),
            Size = new SizeU(new Unit(6, UnitType.Inch), new Unit(0.3, UnitType.Inch))
        });
        report.PageFooterSection = pageFooter;
        
        // Add content
        var htmlTextBox = new Telerik.Reporting.HtmlTextBox()
        {
            Value = "<h1>Report Content</h1><p>This is the main content.</p>"
        };
        report.Items.Add(htmlTextBox);
        
        var instanceReportSource = new Telerik.Reporting.InstanceReportSource();
        instanceReportSource.ReportDocument = report;
        
        var reportProcessor = new ReportProcessor();
        var result = reportProcessor.RenderReport("PDF", instanceReportSource, null);
        
        using (var fs = new System.IO.FileStream("report_with_headers.pdf", System.IO.FileMode.Create))
        {
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length);
        }
    }
}

// NuGet: Install-Package Telerik.Reporting
using Telerik.Reporting;
using Telerik.Reporting.Processing;
using Telerik.Reporting.Drawing;

class TelerikExample
{
    static void Main()
    {
        var report = new Telerik.Reporting.Report();
        
        // Add page header
        var pageHeader = new Telerik.Reporting.PageHeaderSection();
        pageHeader.Height = new Unit(0.5, UnitType.Inch);
        pageHeader.Items.Add(new Telerik.Reporting.TextBox()
        {
            Value = "Document Header",
            Location = new PointU(0, 0),
            Size = new SizeU(new Unit(6, UnitType.Inch), new Unit(0.3, UnitType.Inch))
        });
        report.PageHeaderSection = pageHeader;
        
        // Add page footer
        var pageFooter = new Telerik.Reporting.PageFooterSection();
        pageFooter.Height = new Unit(0.5, UnitType.Inch);
        pageFooter.Items.Add(new Telerik.Reporting.TextBox()
        {
            Value = "Page {PageNumber} of {PageCount}",
            Location = new PointU(0, 0),
            Size = new SizeU(new Unit(6, UnitType.Inch), new Unit(0.3, UnitType.Inch))
        });
        report.PageFooterSection = pageFooter;
        
        // Add content
        var htmlTextBox = new Telerik.Reporting.HtmlTextBox()
        {
            Value = "<h1>Report Content</h1><p>This is the main content.</p>"
        };
        report.Items.Add(htmlTextBox);
        
        var instanceReportSource = new Telerik.Reporting.InstanceReportSource();
        instanceReportSource.ReportDocument = report;
        
        var reportProcessor = new ReportProcessor();
        var result = reportProcessor.RenderReport("PDF", instanceReportSource, null);
        
        using (var fs = new System.IO.FileStream("report_with_headers.pdf", System.IO.FileMode.Create))
        {
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length);
        }
    }
}

' NuGet: Install-Package Telerik.Reporting
Imports Telerik.Reporting
Imports Telerik.Reporting.Processing
Imports Telerik.Reporting.Drawing

Class TelerikExample
    Shared Sub Main()
        Dim report As New Telerik.Reporting.Report()

        ' Add page header
        Dim pageHeader As New Telerik.Reporting.PageHeaderSection()
        pageHeader.Height = New Unit(0.5, UnitType.Inch)
        pageHeader.Items.Add(New Telerik.Reporting.TextBox() With {
            .Value = "Document Header",
            .Location = New PointU(0, 0),
            .Size = New SizeU(New Unit(6, UnitType.Inch), New Unit(0.3, UnitType.Inch))
        })
        report.PageHeaderSection = pageHeader

        ' Add page footer
        Dim pageFooter As New Telerik.Reporting.PageFooterSection()
        pageFooter.Height = New Unit(0.5, UnitType.Inch)
        pageFooter.Items.Add(New Telerik.Reporting.TextBox() With {
            .Value = "Page {PageNumber} of {PageCount}",
            .Location = New PointU(0, 0),
            .Size = New SizeU(New Unit(6, UnitType.Inch), New Unit(0.3, UnitType.Inch))
        })
        report.PageFooterSection = pageFooter

        ' Add content
        Dim htmlTextBox As New Telerik.Reporting.HtmlTextBox() With {
            .Value = "<h1>Report Content</h1><p>This is the main content.</p>"
        }
        report.Items.Add(htmlTextBox)

        Dim instanceReportSource As New Telerik.Reporting.InstanceReportSource()
        instanceReportSource.ReportDocument = report

        Dim reportProcessor As New ReportProcessor()
        Dim result = reportProcessor.RenderReport("PDF", instanceReportSource, Nothing)

        Using fs As New System.IO.FileStream("report_with_headers.pdf", System.IO.FileMode.Create)
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length)
        End Using
    End Sub
End Class

' NuGet: Install-Package Telerik.Reporting
Imports Telerik.Reporting
Imports Telerik.Reporting.Processing
Imports Telerik.Reporting.Drawing

Class TelerikExample
    Shared Sub Main()
        Dim report As New Telerik.Reporting.Report()

        ' Add page header
        Dim pageHeader As New Telerik.Reporting.PageHeaderSection()
        pageHeader.Height = New Unit(0.5, UnitType.Inch)
        pageHeader.Items.Add(New Telerik.Reporting.TextBox() With {
            .Value = "Document Header",
            .Location = New PointU(0, 0),
            .Size = New SizeU(New Unit(6, UnitType.Inch), New Unit(0.3, UnitType.Inch))
        })
        report.PageHeaderSection = pageHeader

        ' Add page footer
        Dim pageFooter As New Telerik.Reporting.PageFooterSection()
        pageFooter.Height = New Unit(0.5, UnitType.Inch)
        pageFooter.Items.Add(New Telerik.Reporting.TextBox() With {
            .Value = "Page {PageNumber} of {PageCount}",
            .Location = New PointU(0, 0),
            .Size = New SizeU(New Unit(6, UnitType.Inch), New Unit(0.3, UnitType.Inch))
        })
        report.PageFooterSection = pageFooter

        ' Add content
        Dim htmlTextBox As New Telerik.Reporting.HtmlTextBox() With {
            .Value = "<h1>Report Content</h1><p>This is the main content.</p>"
        }
        report.Items.Add(htmlTextBox)

        Dim instanceReportSource As New Telerik.Reporting.InstanceReportSource()
        instanceReportSource.ReportDocument = report

        Dim reportProcessor As New ReportProcessor()
        Dim result = reportProcessor.RenderReport("PDF", instanceReportSource, Nothing)

        Using fs As New System.IO.FileStream("report_with_headers.pdf", System.IO.FileMode.Create)
            fs.Write(result.DocumentBytes, 0, result.DocumentBytes.Length)
        End Using
    End Sub
End Class

IronPDFのアプローチ:

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        // Configure header and footer
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Document Header</div>"
        };
        
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        };
        
        var pdf = renderer.RenderHtmlAsPdf("<h1>Report Content</h1><p>This is the main content.</p>");
        pdf.SaveAs("report_with_headers.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        // Configure header and footer
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Document Header</div>"
        };
        
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        };
        
        var pdf = renderer.RenderHtmlAsPdf("<h1>Report Content</h1><p>This is the main content.</p>");
        pdf.SaveAs("report_with_headers.pdf");
    }
}

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Rendering
Imports System

Class IronPdfExample
    Shared Sub Main()
        Dim renderer As New ChromePdfRenderer()

        ' Configure header and footer
        renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
            .HtmlFragment = "<div style='text-align:center'>Document Header</div>"
        }

        renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
            .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        }

        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Report Content</h1><p>This is the main content.</p>")
        pdf.SaveAs("report_with_headers.pdf")
    End Sub
End Class

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Rendering
Imports System

Class IronPdfExample
    Shared Sub Main()
        Dim renderer As New ChromePdfRenderer()

        ' Configure header and footer
        renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
            .HtmlFragment = "<div style='text-align:center'>Document Header</div>"
        }

        renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
            .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        }

        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Report Content</h1><p>This is the main content.</p>")
        pdf.SaveAs("report_with_headers.pdf")
    End Sub
End Class

Telerik Reportingでは、TextBoxアイテムを管理する必要があります。 IronPDFのHTMLベースのアプローチは、{total-pages}のような馴染みのあるCSSスタイリングと簡単なプレースホルダーを使用します。

ヘッダーとフッターのオプションについては、headers and footers documentationをご覧ください。

TelerikレポートAPIからIronPDFへのマッピングリファレンス

このマッピングは、APIと同等のものを直接示すことで、移行を加速します：

Telerik レポート	IronPDF
`Report` クラス	`ChromePdfRenderer`
`ReportProcessor`	`renderer.RenderHtmlAsPdf()`
`ReportSource`	HTML文字列またはファイル
`.trdp` / `.trdx` ファイル	HTML/CSSテンプレート
`ReportParameter`	文字列補間 / Razor
`ReportDataSource`	C#データバインディング
`RenderReport("PDF")`	`RenderHtmlAsPdf()`
`Export()`	`pdf.SaveAs()`
`TextBox` レポートアイテム	HTML `<div>`
`Table` レポートアイテム	HTML `<table>`
`PictureBox`	HTML `<img>`
`PageSettings`	`RenderingOptions`

一般的な移行の問題と解決策

課題1: レポート定義 (.trdp/.trdx ファイル)

Telerik Reportingは、直接変換できない独自のXMLレポート定義を使用しています。

解決策：デザイナーでレポートを開き、レイアウト、データバインディング、フォーマットを文書化し、HTML/CSSテンプレートとして再作成することで、HTMLテンプレートに変換します。複雑なシナリオでのデータバインディングに Razor を使用してください。

課題2: データソースのバインディング

Telerik Reportingは、SqlDataSourceとオブジェクトデータソースを式バインディングとともに使用します。

ソリューション: C#でデータを取得し、HTMLにバインドする：

var data = await dbContext.Orders.ToListAsync();
var html = $"<table>{string.Join("", data.Select(d => $"<tr><td>{d.Name}</td></tr>"))}</table>";

var data = await dbContext.Orders.ToListAsync();
var html = $"<table>{string.Join("", data.Select(d => $"<tr><td>{d.Name}</td></tr>"))}</table>";

Dim data = Await dbContext.Orders.ToListAsync()
Dim html = $"<table>{String.Join("", data.Select(Function(d) $"<tr><td>{d.Name}</td></tr>"))}</table>"

Dim data = Await dbContext.Orders.ToListAsync()
Dim html = $"<table>{String.Join("", data.Select(Function(d) $"<tr><td>{d.Name}</td></tr>"))}</table>"

課題3：レポート・パラメータ

Telerik Reportingは、組み込みのパラメータUIを持つReportParameterを使用します。

解決策： HTML生成に直接パラメータを渡します：

public string GenerateReport(string customerId, DateTime fromDate)
{
    return $"<h1>Report for {customerId}</h1><p>From: {fromDate:d}</p>";
}

public string GenerateReport(string customerId, DateTime fromDate)
{
    return $"<h1>Report for {customerId}</h1><p>From: {fromDate:d}</p>";
}

Public Function GenerateReport(customerId As String, fromDate As DateTime) As String
    Return $"<h1>Report for {customerId}</h1><p>From: {fromDate:d}</p>"
End Function

Public Function GenerateReport(customerId As String, fromDate As DateTime) As String
    Return $"<h1>Report for {customerId}</h1><p>From: {fromDate:d}</p>"
End Function

課題4：インタラクティブな機能

Telerik Reportingは、ビューアでドリルダウン、ソート、フィルタリングを提供します。

ソリューション: IronPDFは静的PDFを生成します。インタラクティブ性については、ウェブUIにデータを保持し、ユーザーが "Export "をクリックしたときにPDFを生成します。これにより、インタラクティブなデータ探索と文書生成の間の懸念を分離することができます。

Telerikレポート移行のチェックリスト

マイグレーション前のタスク

コードベースを監査して、Telerik Reportingの使用法をすべて特定します：

grep -r "using Telerik.Reporting" --include="*.cs" .
grep -r "Report\|ReportProcessor" --include="*.cs" .

grep -r "using Telerik.Reporting" --include="*.cs" .
grep -r "Report\|ReportProcessor" --include="*.cs" .

SHELL

データソースとパラメータを文書化し、現在のレポートレイアウトをスクリーンショットで撮影して視覚的に参照できるようにし、再利用可能なHTMLテンプレートに変換できる共有レポートコンポーネントを特定します。

コード更新タスク

1.Telerik NuGetパッケージの削除 2.IronPDFNuGet パッケージをインストールします 3. .trdxファイルをHTMLテンプレートに変換します 4. ChromePdfRendererに置き換えます 5.文字列補間またはRazorへのデータバインディングの更新 6. HtmlHeaderFooterを使用してヘッダー/フッターをHTMLに変換します 7.起動時のライセンス初期化を追加

移行後のテスト

移行後、これらの点を検証してください：

PDF出力を元のレポートと視覚的に比較
生成されたPDFのデータ精度の検証
複数ページのドキュメントのページネーションのテスト
すべてのページでヘッダー/フッターが正しく表示されていることを確認します。
大量シナリオのパフォーマンステストの実施

IronPDFに移行する主な利点

Telerik ReportingからIronPDFに移行することで、PDF生成に特化したチームにはいくつかの利点があります：

**最新の Chromium レンダリングエンジン:**IronPDFはGoogle Chrome と同じレンダリングエンジンを使用しているため、PDF は最新のブラウザーに表示されるコンテンツとまったく同じようにレンダリングされます。 CSS3とJavaScriptを完全にサポートしているため、WebデザインはPDFに直接翻訳されます。

**簡素化されたライセンス:**IronPDFは、包括的なスイートを購入する必要なく、開発者ごとのライセンスを提供します。 PDF生成のみを必要とするチームにとっては、大幅なコスト削減となります。

標準 Web テクノロジー: HTML、CSS、 JavaScript は、すべての Web 開発者が持つスキルです。独自のテンプレート形式や専門的なデザイナーツールを学ぶ必要はありません。

より小さい展開フットプリント:レポートサービスインフラストラクチャとデザイナーコンポーネントがないため、展開はより簡単かつ迅速になります。

アクティブな開発： IronPDFの定期的なアップデートは現在 for .NETバージョンを追跡するため、最新 for .NETにあるプロジェクトは四半期ごとのレポートリリースを待たずにサポートされ続けます。

ご注意: Telerikはその所有者の登録商標です。このサイトはProgress Softwareとは提携しておらず、承認またはスポンサードを受けていません。すべての製品名、ロゴ、およびブランドは各所有者の所有物です。比較は情報提供のみを目的としており、執筆時点で公開されている情報を反映しています。

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

...

詳しく読む