C#でSSRSからIronPDFに移行する方法
SQL Server Reporting Services (SSRS)からIronPDFに移行することで、PDF生成のワークフローが、重量のあるサーバーベースのインフラストラクチャから、.NETアプリケーションに直接埋め込むことができる軽量のインプロセスライブラリに変わります。 このガイドでは、SQL Serverへの依存、レポートサーバーのオーバーヘッド、Microsoftエコシステムのロックインを排除する、完全で段階的な移行パスを提供します。
なぜSSRSからIronPDFに移行するのか
SSRSについて
SQL Server Reporting Services(SSRS)は、Microsoftのエンタープライズレポーティングプラットフォームで、多額のインフラ投資が必要です。 SSRSは、レポートの作成、展開、管理のための完全なスイートを提供するMicrosoftの包括的なレポートプラットフォームであり、豊富な機能とインタラクティブなレポート機能の両方を提供します。 SQL Serverエコシステムの一部として開発されたSSRSは、マイクロソフトのデータベースソリューションと緊密に統合されています。
しかし、多くのPDF生成シナリオでは、SSRSインフラストラクチャは過剰です。移行する主な理由は以下の通りです:
1.高度なインフラストラクチャ: SQL Server、レポート サーバー、IIS の構成が必要です
- Microsoftエコシステムのロックイン: SQL ServerライセンスとWindows Serverに結びついている 3.複雑な展開:レポートの展開、セキュリティ構成、サブスクリプション管理 4.高価なライセンス: SQL Server ライセンス、特にエンタープライズ機能向け
- Webサポートが限られている:最新のSPAフレームワークとの統合が難しい 6.メンテナンスオーバーヘッド:サーバーのパッチ適用、データベースのメンテナンス、レポート管理 7.クラウドネイティブオプションなし:オンプレミス向けに設計されているため、クラウドサポートが不便
SSRSが過剰な場合
| ニーズ | SSRSオーバーヘッド |
|---|---|
| 請求書の作成 | フルレポートサーバー |
| データテーブルのエクスポート | SQL Serverライセンス |
| データからPDFを作成 | Windowsサーバー |
| シンプルなドキュメント生成 | レポート購読 |
IronPdfはサーバーのインフラなしでインプロセスでPDFを生成します。
SSRSとIronPDFの比較
| フィーチャー | SSRS | IronPDF |
|---|---|---|
| 依存性について | SQL Serverが必要です。 | データベースへの依存なし |
| デプロイメント | サーバーベース | ライブラリ(アプリケーションへの組み込み) |
| 統合。 | マイクロソフトとの緊密な統合 | あらゆるデータソースに対応 |
| データビジュアライゼーション | 豊富なネイティブオプション | PDFを中心としたビジュアライゼーション |
| 複雑さ | 高(サーバー設定が必要) | 中~低レベル(ライブラリのセットアップ) |
| 費用 | SQL Serverのライセンス費用 | 開発者1人あたりのライセンス費用 |
| HTMLからPDFへ | なし | 完全なChromium |
| URLからPDFへ。 | なし | はい |
| CSSサポート | 制限的 | 完全なCSS3 |
| JavaScript(ジャバスクリプト | なし | フルES2024 |
IronPdfはSSRSとは異なり、特定のデータベースやサーバーエコシステムに縛られることはありません。 C#で直接PDF文書を動的に作成、編集、操作するための柔軟なライブラリを開発者に提供します。 サーバーベースのインフラストラクチャから切り離されることで、顕著な利点が得られます。
2025年と2026年まで.NET 10とC# 14の採用を計画しているチームに対して、IronPDFはSSRSのインフラストラクチャの複雑さを解消する最新のChromiumレンダリングエンジンを提供します。
始める前に
前提条件
- .NET 環境: .NET Framework 4.6.2+ または .NET Core 3.1+ / .NET 5/6/7/8/9+
- NuGetアクセス: NuGetパッケージをインストールする機能
- IronPDFライセンス: ironpdf.comからライセンスキーを取得します。
NuGetパッケージの変更
#SSRShas no direct NuGet - it's server-based
# Remove any ReportViewer controls
dotnet remove package Microsoft.ReportingServices.ReportViewerControl.WebForms
dotnet remove package Microsoft.ReportingServices.ReportViewerControl.WinForms
# Install IronPDF
dotnet add package IronPdf#SSRShas no direct NuGet - it's server-based
# Remove any ReportViewer controls
dotnet remove package Microsoft.ReportingServices.ReportViewerControl.WebForms
dotnet remove package Microsoft.ReportingServices.ReportViewerControl.WinForms
# Install IronPDF
dotnet add package IronPdfライセンス構成
// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";完全な API リファレンス
名前空間の変更
// Before: SSRS
using Microsoft.Reporting.WebForms;
using Microsoft.Reporting.WinForms;
// After: IronPDF
using IronPdf;
using IronPdf.Rendering;// Before: SSRS
using Microsoft.Reporting.WebForms;
using Microsoft.Reporting.WinForms;
// After: IronPDF
using IronPdf;
using IronPdf.Rendering;コア API マッピング
| SSRSのコンセプト | IronPDF 同等物 | ノート |
|---|---|---|
| <コード>LocalReport</コード | <コード>ChromePdfRenderer</コード | コアレンダリング |
| <コード>ServerReport</コード | RenderUrlAsPdf()を使用してください。 | URLベースのレンダリング |
.rdlcファイル | HTML/CSSテンプレート | テンプレート形式 |
ReportParameter(レポートパラメータ | 文字列の補間 | パラメータ |
| <コード>ReportDataSource</コード | C#データ + HTML | データバインディング |
LocalReport.Render("PDF")。 | <コード>RenderHtmlAsPdf()</コード | PDF出力 |
| <コード>サブレポート</コード | マージされたPDF | ネストされたレポート |
| <コード>レポートサーバのURL</コード | 不要 | サーバー不要 |
ReportViewerコントロール | 不要 | 直接PDF生成 |
| エクスポート形式 | PDFはネイティブ | フォーカスされたアウトプット |
コード移行の例
例1: HTMLからPDFへの変換
ビフォア (SSRS):
//SSRS- SQL Server Reporting Services
using System;
using System.Data;
using System.Data.SqlClient;
using Microsoft.Reporting.WebForms;
using System.IO;
class SSRSHtmlToPdf
{
static void Main()
{
// Create a ReportViewer instance
var reportViewer = new ReportViewer();
reportViewer.ProcessingMode = ProcessingMode.Local;
// Load RDLC report definition
reportViewer.LocalReport.ReportPath = "Report.rdlc";
// Add HTML content as a parameter or dataset
var htmlContent = "<h1>Hello World</h1><p>This is HTML content.</p>";
var param = new ReportParameter("HtmlContent", htmlContent);
reportViewer.LocalReport.SetParameters(param);
// Render the report to PDF
string mimeType, encoding, fileNameExtension;
string[] streams;
Warning[] warnings;
byte[] bytes = reportViewer.LocalReport.Render(
"PDF",
null,
out mimeType,
out encoding,
out fileNameExtension,
out streams,
out warnings);
File.WriteAllBytes("output.pdf", bytes);
}
}//SSRS- SQL Server Reporting Services
using System;
using System.Data;
using System.Data.SqlClient;
using Microsoft.Reporting.WebForms;
using System.IO;
class SSRSHtmlToPdf
{
static void Main()
{
// Create a ReportViewer instance
var reportViewer = new ReportViewer();
reportViewer.ProcessingMode = ProcessingMode.Local;
// Load RDLC report definition
reportViewer.LocalReport.ReportPath = "Report.rdlc";
// Add HTML content as a parameter or dataset
var htmlContent = "<h1>Hello World</h1><p>This is HTML content.</p>";
var param = new ReportParameter("HtmlContent", htmlContent);
reportViewer.LocalReport.SetParameters(param);
// Render the report to PDF
string mimeType, encoding, fileNameExtension;
string[] streams;
Warning[] warnings;
byte[] bytes = reportViewer.LocalReport.Render(
"PDF",
null,
out mimeType,
out encoding,
out fileNameExtension,
out streams,
out warnings);
File.WriteAllBytes("output.pdf", bytes);
}
}翻訳後(IronPDF):。
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class IronPdfHtmlToPdf
{
static void Main()
{
// Create a ChromePdfRenderer instance
var renderer = new ChromePdfRenderer();
// Convert HTML string to PDF
var htmlContent = "<h1>Hello World</h1><p>This is HTML content.</p>";
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
// Save the PDF file
pdf.SaveAs("output.pdf");
}
}// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class IronPdfHtmlToPdf
{
static void Main()
{
// Create a ChromePdfRenderer instance
var renderer = new ChromePdfRenderer();
// Convert HTML string to PDF
var htmlContent = "<h1>Hello World</h1><p>This is HTML content.</p>";
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
// Save the PDF file
pdf.SaveAs("output.pdf");
}
}この例は、基本的なアーキテクチャの違いを示しています。 SSRSでは、ReportViewerインスタンスを作成し、.rdlcレポート定義ファイルをロードし、パラメータを設定し、メタデータのために複数のoutパラメータでLocalReport.Render("PDF")を呼び出す必要があります。
IronPdfはChromePdfRendererとRenderHtmlAsPdf()をわずか3行のコードで使用します。 レポート定義ファイル、パラメータオブジェクト、メタデータの処理は不要です。 包括的な例については、HTML to PDF documentationを参照してください。
例2: ヘッダーとフッター付きのURLからPDFへ
ビフォア (SSRS):
//SSRS- SQL Server Reporting Services
using System;
using System.IO;
using System.Net;
using Microsoft.Reporting.WebForms;
class SSRSUrlToPdf
{
static void Main()
{
// Download HTML content from URL
string url = "https://example.com";
string htmlContent;
using (var client = new WebClient())
{
htmlContent = client.DownloadString(url);
}
// Create RDLC report with header/footer configuration
var reportViewer = new ReportViewer();
reportViewer.ProcessingMode = ProcessingMode.Local;
reportViewer.LocalReport.ReportPath = "WebReport.rdlc";
// Set parameters for header and footer
var parameters = new ReportParameter[]
{
new ReportParameter("HeaderText", "Company Report"),
new ReportParameter("FooterText", "Page " + DateTime.Now.ToString()),
new ReportParameter("HtmlContent", htmlContent)
};
reportViewer.LocalReport.SetParameters(parameters);
// Render to PDF
string mimeType, encoding, fileNameExtension;
string[] streams;
Warning[] warnings;
byte[] bytes = reportViewer.LocalReport.Render(
"PDF", null, out mimeType, out encoding,
out fileNameExtension, out streams, out warnings);
File.WriteAllBytes("webpage.pdf", bytes);
}
}//SSRS- SQL Server Reporting Services
using System;
using System.IO;
using System.Net;
using Microsoft.Reporting.WebForms;
class SSRSUrlToPdf
{
static void Main()
{
// Download HTML content from URL
string url = "https://example.com";
string htmlContent;
using (var client = new WebClient())
{
htmlContent = client.DownloadString(url);
}
// Create RDLC report with header/footer configuration
var reportViewer = new ReportViewer();
reportViewer.ProcessingMode = ProcessingMode.Local;
reportViewer.LocalReport.ReportPath = "WebReport.rdlc";
// Set parameters for header and footer
var parameters = new ReportParameter[]
{
new ReportParameter("HeaderText", "Company Report"),
new ReportParameter("FooterText", "Page " + DateTime.Now.ToString()),
new ReportParameter("HtmlContent", htmlContent)
};
reportViewer.LocalReport.SetParameters(parameters);
// Render to PDF
string mimeType, encoding, fileNameExtension;
string[] streams;
Warning[] warnings;
byte[] bytes = reportViewer.LocalReport.Render(
"PDF", null, out mimeType, out encoding,
out fileNameExtension, out streams, out warnings);
File.WriteAllBytes("webpage.pdf", bytes);
}
}翻訳後(IronPDF):。
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;
class IronPdfUrlToPdf
{
static void Main()
{
// Create a ChromePdfRenderer instance
var renderer = new ChromePdfRenderer();
// Configure rendering options with header and footer
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages} - " + DateTime.Now.ToString("MM/dd/yyyy") + "</div>"
};
// Convert URL to PDF
string url = "https://example.com";
var pdf = renderer.RenderUrlAsPdf(url);
// Save the PDF file
pdf.SaveAs("webpage.pdf");
}
}// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;
class IronPdfUrlToPdf
{
static void Main()
{
// Create a ChromePdfRenderer instance
var renderer = new ChromePdfRenderer();
// Configure rendering options with header and footer
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages} - " + DateTime.Now.ToString("MM/dd/yyyy") + "</div>"
};
// Convert URL to PDF
string url = "https://example.com";
var pdf = renderer.RenderUrlAsPdf(url);
// Save the PDF file
pdf.SaveAs("webpage.pdf");
}
}SSRSはURLを直接PDFに変換することはできません。 WebClient.DownloadString()でHTMLコンテンツを手動でダウンロードし、別の.rdlcレポートファイルを作成し、HTMLとヘッダー/フッターテキストをReportParameter配列として渡し、複雑なRender()メソッドシグネチャでレンダリングする必要があります。
IronPDFのRenderUrlAsPdf()は一回の呼び出しですべての処理を行います。 ヘッダーとフッターは、完全なHTML/CSSと{page}や{total-pages}のようなプレースホルダーをサポートするHtmlHeaderFooterオブジェクトで構成されます。 詳しくは、チュートリアルをご覧ください。
例3: データベース駆動型レポート
ビフォア (SSRS):
//SSRS- SQL Server Reporting Services
using System;
using System.Data;
using System.Data.SqlClient;
using Microsoft.Reporting.WebForms;
using System.IO;
class SSRSDatabaseReport
{
static void Main()
{
// Create a ReportViewer instance
var reportViewer = new ReportViewer();
reportViewer.ProcessingMode = ProcessingMode.Local;
reportViewer.LocalReport.ReportPath = "SalesReport.rdlc";
// Create database connection and fetch data
string connString = "Server=localhost;Database=SalesDB;Integrated Security=true;";
using (var connection = new SqlConnection(connString))
{
var adapter = new SqlDataAdapter("SELECT * FROM Sales", connection);
var dataSet = new DataSet();
adapter.Fill(dataSet, "Sales");
// Bind data to report
var dataSource = new ReportDataSource("SalesDataSet", dataSet.Tables[0]);
reportViewer.LocalReport.DataSources.Clear();
reportViewer.LocalReport.DataSources.Add(dataSource);
}
// Render to PDF
string mimeType, encoding, fileNameExtension;
string[] streams;
Warning[] warnings;
byte[] bytes = reportViewer.LocalReport.Render(
"PDF", null, out mimeType, out encoding,
out fileNameExtension, out streams, out warnings);
File.WriteAllBytes("sales-report.pdf", bytes);
}
}//SSRS- SQL Server Reporting Services
using System;
using System.Data;
using System.Data.SqlClient;
using Microsoft.Reporting.WebForms;
using System.IO;
class SSRSDatabaseReport
{
static void Main()
{
// Create a ReportViewer instance
var reportViewer = new ReportViewer();
reportViewer.ProcessingMode = ProcessingMode.Local;
reportViewer.LocalReport.ReportPath = "SalesReport.rdlc";
// Create database connection and fetch data
string connString = "Server=localhost;Database=SalesDB;Integrated Security=true;";
using (var connection = new SqlConnection(connString))
{
var adapter = new SqlDataAdapter("SELECT * FROM Sales", connection);
var dataSet = new DataSet();
adapter.Fill(dataSet, "Sales");
// Bind data to report
var dataSource = new ReportDataSource("SalesDataSet", dataSet.Tables[0]);
reportViewer.LocalReport.DataSources.Clear();
reportViewer.LocalReport.DataSources.Add(dataSource);
}
// Render to PDF
string mimeType, encoding, fileNameExtension;
string[] streams;
Warning[] warnings;
byte[] bytes = reportViewer.LocalReport.Render(
"PDF", null, out mimeType, out encoding,
out fileNameExtension, out streams, out warnings);
File.WriteAllBytes("sales-report.pdf", bytes);
}
}翻訳後(IronPDF):。
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Data;
using System.Data.SqlClient;
using System.Text;
class IronPdfDatabaseReport
{
static void Main()
{
// Create database connection and fetch data
string connString = "Server=localhost;Database=SalesDB;Integrated Security=true;";
var dataTable = new DataTable();
using (var connection = new SqlConnection(connString))
{
var adapter = new SqlDataAdapter("SELECT * FROM Sales", connection);
adapter.Fill(dataTable);
}
// Build HTML table from data
var htmlBuilder = new StringBuilder();
htmlBuilder.Append("<h1>Sales Report</h1><table border='1'><tr>");
foreach (DataColumn column in dataTable.Columns)
htmlBuilder.Append($"<th>{column.ColumnName}</th>");
htmlBuilder.Append("</tr>");
foreach (DataRow row in dataTable.Rows)
{
htmlBuilder.Append("<tr>");
foreach (var item in row.ItemArray)
htmlBuilder.Append($"<td>{item}</td>");
htmlBuilder.Append("</tr>");
}
htmlBuilder.Append("</table>");
// Convert to PDF
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlBuilder.ToString());
pdf.SaveAs("sales-report.pdf");
}
}// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Data;
using System.Data.SqlClient;
using System.Text;
class IronPdfDatabaseReport
{
static void Main()
{
// Create database connection and fetch data
string connString = "Server=localhost;Database=SalesDB;Integrated Security=true;";
var dataTable = new DataTable();
using (var connection = new SqlConnection(connString))
{
var adapter = new SqlDataAdapter("SELECT * FROM Sales", connection);
adapter.Fill(dataTable);
}
// Build HTML table from data
var htmlBuilder = new StringBuilder();
htmlBuilder.Append("<h1>Sales Report</h1><table border='1'><tr>");
foreach (DataColumn column in dataTable.Columns)
htmlBuilder.Append($"<th>{column.ColumnName}</th>");
htmlBuilder.Append("</tr>");
foreach (DataRow row in dataTable.Rows)
{
htmlBuilder.Append("<tr>");
foreach (var item in row.ItemArray)
htmlBuilder.Append($"<td>{item}</td>");
htmlBuilder.Append("</tr>");
}
htmlBuilder.Append("</table>");
// Convert to PDF
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlBuilder.ToString());
pdf.SaveAs("sales-report.pdf");
}
}SSRSでは、あらかじめデザインされた.rdlcレポートファイル("SalesReport.rdlc")、DataSetへの入力、レポート定義と一致しなければならない特定の名前("SalesDataSet")を持つReportDataSourceの作成、既存のデータソースのクリア、新しいデータソースの追加、そしてレンダリングが必要です。
IronPDFは既存のデータアクセスコード(同じSqlDataAdapterパターン)を使用し、StringBuilderで動的にHTMLを構築します。 標準的なHTML/CSSを使用してレイアウトを完全に制御できます。
機能比較
| フィーチャー | SSRS | IronPDF |
|---|---|---|
| インフラストラクチャ | ||
| 必要なサーバー | はい(レポートサーバー) | なし |
| SQL Serverライセンス | 必須 | 不要 |
| Windowsサーバー | 必須 | プラットフォーム |
| データベース必須 | はい(ReportServer DB) | なし |
| 開発分野 | ||
| ビジュアルデザイナー | はい (.rdlc) | HTMLエディタ |
| テンプレート形式 | RDLC/RDL | HTML/CSS/Razor |
| データソース | 組み込みDSN | あらゆるC#データ |
| レンダリング。 | ||
| HTMLからPDFへ | なし | 完全なChromium |
| URLからPDFへ | なし | はい |
| CSSサポート | 制限的 | 完全なCSS3 |
| JavaScript | なし | フルES2024 |
| チャート | 内蔵 | JSライブラリ経由 |
| デプロイメント | ||
| レポートの展開 | サーバーへ | アプリ |
| 構成 | 複雑 | 単純 |
| メンテナンス | 高い | 低レベル |
よくある移行の問題
課題1: RDLCレポートの定義
SSRS:独自の.rdlc XMLフォーマットを使用します。
ソリューション: HTMLテンプレートに変換する: 1.Visual Studioで.rdlcを開く 2.レイアウト構造の文書化 3.HTML/CSSで再作成 4.データバインディングにRazorを使用する
課題2:共有データソース
SSRS:レポートサーバーの接続文字列。
ソリューション: アプリケーションのデータアクセスレイヤーを使用してください:
var data = await _dbContext.Sales.ToListAsync();
// Then bind to HTML templatevar data = await _dbContext.Sales.ToListAsync();
// Then bind to HTML template課題3:レポートパラメータUI
SSRS:組み込みパラメータプロンプト。
ソリューション: アプリケーションでパラメータUIを構築する:
// Your own parameter form, then:
var pdf = GenerateReport(startDate, endDate, region);// Your own parameter form, then:
var pdf = GenerateReport(startDate, endDate, region);課題4:定期購読/定期レポート
SSRS:組み込みのサブスクリプションエンジン。
解決策:バックグラウンド・ジョブ・フレームワークを使用する:
// Using Hangfire or similar
RecurringJob.AddOrUpdate("weekly-report",
() => GenerateAndEmailReport(), Cron.Weekly);// Using Hangfire or similar
RecurringJob.AddOrUpdate("weekly-report",
() => GenerateAndEmailReport(), Cron.Weekly);移行チェックリスト
移行前
- すべてのSSRSレポート (
.rdlcファイル) をインベントリします。 - データソースと接続を文書化する
- 視覚的な参照のためのスクリーンショットレポートレイアウト
- 各レポートのレポートパラメータを一覧表示する
- サブスクリプションスケジュールをメモする
- ironpdf.comからIronPDFライセンスキーを取得します
コードの更新
- ReportViewer パッケージを削除する
IronPdfNuGetパッケージをインストールする.rdlcファイルを HTML テンプレートに変換する -<コード>LocalReport</コードChromePdfRendererに置き換える -<コード>ReportDataSource</コードC# データ + HTML テンプレートに置き換えますReportParameter文字列補間で置き換えるLocalReport.Render("PDF")をRenderHtmlAsPdf()に置き換えますHtmlHeaderFooterを使用してヘッダー/フッターを実装する- アプリケーションの起動時にライセンスの初期化を追加
インフラ
- レポートサーバーの廃止を計画する
- サブスクリプションをジョブ スケジューラ (Hangfire など) に移行する
- デプロイメントスクリプトを更新する
テスティング
- PDF出力を視覚的に比較する
- データの正確性を確認する
- テストページネーション
- すべてのパラメータを確認する
- パフォーマンステスト






