移行ガイド

C#でGdPicture.NET SDKからIronPDFに移行する方法

更新日:2026年2月1日

GdPicture.NETSDKからIronPDFへの移行は、.NET開発者にPDF生成への集中した合理的なアプローチを提供します。このガイドは、複雑なドキュメントイメージングSDKのパターンを、現代 for .NET開発用に設計された最新のPDF固有のAPIに置き換える、包括的でステップバイステップの移行パスを提供します。

GdPicture.NETSDKからIronPDFへ移行する理由

GdPicture.NETのSDKの課題

GdPicture.NET SDK（現在はNutrientとしてリブランド）は、包括的なドキュメントイメージングSDKで、PDFに特化した開発にはいくつかの課題があります：

PDF のみのプロジェクトには過剰: GdPicture .NET SDK は、OCR、バーコード認識、スキャン、画像処理を含む完全なドキュメントイメージングスイートです。 PDFの機能だけが必要な場合、決して使わない機能のためにお金を払うことになります。

2.複雑なライセンス:複数の製品層 (GdPicture .NET 14、GdPicture.API、Ultimate、Professional) があり、SKU の組み合わせがわかりにくく、年間サブスクリプション要件があります。

3.エンタープライズ価格:ライセンス料金は、PDF プラグインのみの場合は 2,999 ドルから始まり、Ultimate エディションの場合は 10,000 ドル以上になります。開発者ごとのライセンスは、成長するチームにとって大きなオーバーヘッドとなります。

4.学習曲線が急: API は、最新 for .NETパターンではなく、ドキュメントイメージングの概念に基づいて設計されています。 GdPictureStatus 列挙チェックや 1 から始まるインデックスページなどのメソッドは、現在の C# 規則と比較すると時代遅れに感じられます。

5.ステータスコードパターン:すべての操作は、チェックする必要がある GdPictureStatus 列挙を返します。エラーが発生しても例外はスローされないため、エラー処理が冗長かつ反復的になります。

6.手動リソース管理:明示的な Dispose() または Release() 呼び出しが必要です。 SDKは、標準的な.NETの廃棄パターンにきれいに従っていません。

7.バージョンのロックイン:名前空間 GdPicture14 にはバージョン番号が含まれているため、メジャーバージョンのアップグレードではコードベース全体の名前空間の変更が必要になります。

8.ブランド変更による混乱:最近の"Nutrient"へのブランド変更により、gdpicture.com と nutrient.io の間でドキュメントが断片化され、サポートと学習が複雑になっています。

GdPicture.NETSDKとIronPDFの比較

アスペクト	GdPicture.NET SDK	IronPDF
フォーカス	文書画像処理スイート（PDFはやりすぎ）	PDF専用ライブラリ
価格	2,999～10,000ドル以上のエンタープライズ層	競争力があり、ビジネスと連動する
APIスタイル	ステータスコード、マニュアル管理	例外、IDisposable、モダン.NET
学習曲線	Steep（画像処理SDKのコンセプト）	シンプルなもの（HTML/CSSに精通していること）
HTMLレンダリング	基本的な内部エンジン	最新のChromiumとCSS3/JS
ページインデックス	1-indexed	0-インデックス（標準.NET）
スレッドの安全性	手動同期が必要	スレッドセーフ設計
名前空間	バージョン固有 (`GdPicture14`)	安定版 (`IronPdf`)

2025年、2026年まで.NET 10とC# 14の採用を計画しているチームにとって、IronPDFは最新 for .NETパターンと規約に沿った将来を見据えた基盤を提供します。

マイグレーションの複雑さの評価

機能別の見積もり作業

フィーチャー	移行の複雑さ
HTMLからPDFへ	低レベル
URLからPDFへ	低レベル
PDFのマージ	低レベル
PDFの分割	低レベル
透かし	低レベル
テキスト抽出	低レベル
パスワード保護	中規模
フォームフィールド	中規模
デジタル署名	中・高
OCR	高い
バーコード認識	該当なし

移行の決定マトリックス

お客様の状況	推奨
PDFのみの操作	移行-大幅な簡素化とコスト削減
OCRの多用	IronOCRをコンパニオンプロダクトとしてご検討ください。
バーコード/スキャンのニーズ	これらの機能にはGdPicture.NET SDKを、PDFにはIronPDFを使用してください。
フルドキュメントイメージング	すべての機能を実際に使用するかどうかを評価する

始める前に

前提条件

.NETバージョン: IronPDFは.NET Framework 4.6.2以降および.NET Core 2.0以降 / .NET 5/6/7/8/9以降をサポートしています。 2.ライセンスキー: IronPDFからIronPDFライセンスキーを取得します。 3.バックアップ:移行作業用のブランチを作成する

すべてのGdPicture.NET SDKの使用法を特定する

# Find allGdPicture.NET SDKreferences in your codebase
grep -r "GdPicture14\|GdPicturePDF\|GdPictureDocumentConverter\|GdPictureStatus\|LicenseManager\.RegisterKEY" --include="*.cs" .

# Find all GdPicture package references
grep -r "GdPicture" --include="*.csproj" .

# Find allGdPicture.NET SDKreferences in your codebase
grep -r "GdPicture14\|GdPicturePDF\|GdPictureDocumentConverter\|GdPictureStatus\|LicenseManager\.RegisterKEY" --include="*.cs" .

# Find all GdPicture package references
grep -r "GdPicture" --include="*.csproj" .

SHELL

NuGetパッケージの変更

# RemoveGdPicture.NET SDKpackages
dotnet remove package GdPicture.NET.14
dotnet remove package GdPicture.NET.14.API
dotnet remove package GdPicture
dotnet remove package GdPicture.API

# Install IronPDF
dotnet add package IronPdf

# RemoveGdPicture.NET SDKpackages
dotnet remove package GdPicture.NET.14
dotnet remove package GdPicture.NET.14.API
dotnet remove package GdPicture
dotnet remove package GdPicture.API

# Install IronPDF
dotnet add package IronPdf

SHELL

クイックスタートマイグレーション

ステップ 1: ライセンス構成の更新

以前(GdPicture.NET SDK)：。

// Must be called before anyGdPicture.NET SDKoperations
LicenseManager.RegisterKEY("YOUR-GDPICTURE-LICENSE-KEY");

// Must be called before anyGdPicture.NET SDKoperations
LicenseManager.RegisterKEY("YOUR-GDPICTURE-LICENSE-KEY");

' Must be called before any GdPicture.NET SDK operations
LicenseManager.RegisterKEY("YOUR-GDPICTURE-LICENSE-KEY")

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

// Set once at application startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";

// Or in appsettings.json:
// { "IronPdf.License.LicenseKey": "YOUR-LICENSE-KEY" }

// Set once at application startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";

// Or in appsettings.json:
// { "IronPdf.License.LicenseKey": "YOUR-LICENSE-KEY" }

' Set once at application startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"

' Or in appsettings.json:
' { "IronPdf.License.LicenseKey": "YOUR-LICENSE-KEY" }

$vbLabelText $csharpLabel

ステップ 2: 名前空間インポートを更新する

// Before (GdPicture.NET SDK)
using GdPicture14;

// After (IronPDF)
using IronPdf;
using IronPdf.Editing;

// Before (GdPicture.NET SDK)
using GdPicture14;

// After (IronPDF)
using IronPdf;
using IronPdf.Editing;

Imports IronPdf
Imports IronPdf.Editing

$vbLabelText $csharpLabel

ステップ 3: 基本的な変換パターン

GdPicture.NET SDKの移行における最も大きな変更点は、冗長なステータスチェックのパターンをなくしたことです：

以前(GdPicture.NET SDK)：。

using GdPicture14;

LicenseManager.RegisterKEY("LICENSE-KEY");

using (GdPictureDocumentConverter converter = new GdPictureDocumentConverter())
{
    GdPictureStatus status = converter.LoadFromHTMLString("<h1>Hello World</h1>");

    if (status == GdPictureStatus.OK)
    {
        status = converter.SaveAsPDF("output.pdf");

        if (status != GdPictureStatus.OK)
        {
            Console.WriteLine($"Error: {status}");
        }
    }
    else
    {
        Console.WriteLine($"Load error: {status}");
    }
}

using GdPicture14;

LicenseManager.RegisterKEY("LICENSE-KEY");

using (GdPictureDocumentConverter converter = new GdPictureDocumentConverter())
{
    GdPictureStatus status = converter.LoadFromHTMLString("<h1>Hello World</h1>");

    if (status == GdPictureStatus.OK)
    {
        status = converter.SaveAsPDF("output.pdf");

        if (status != GdPictureStatus.OK)
        {
            Console.WriteLine($"Error: {status}");
        }
    }
    else
    {
        Console.WriteLine($"Load error: {status}");
    }
}

Imports GdPicture14

LicenseManager.RegisterKEY("LICENSE-KEY")

Using converter As New GdPictureDocumentConverter()
    Dim status As GdPictureStatus = converter.LoadFromHTMLString("<h1>Hello World</h1>")

    If status = GdPictureStatus.OK Then
        status = converter.SaveAsPDF("output.pdf")

        If status <> GdPictureStatus.OK Then
            Console.WriteLine($"Error: {status}")
        End If
    Else
        Console.WriteLine($"Load error: {status}")
    End If
End Using

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

using IronPdf;

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

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
pdf.SaveAs("output.pdf");

using IronPdf;

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

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
pdf.SaveAs("output.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "LICENSE-KEY"

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
pdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

主な違い:

ステータスチェックなし-エラー時の例外処理
レンダラーの明示的な廃棄は不要
最新の流暢なAPI
Chromiumベースのレンダリングにより、HTML/CSSのサポートが向上しました。

完全な API リファレンス

名前空間マッピング

GdPicture.NET SDK	IronPDF
`GdPicture14`	`IronPdf`
`GdPicture14.PDF`	`IronPdf`
`GdPicture14.Imaging`	該当なし(不要)

コアクラスマッピング

GdPicture.NET SDK	IronPDF	翻訳内容
`GdPicturePDF`	`PdfDocument`	主なPDF文書クラス
`GdPictureDocumentConverter`	`ChromePdfRenderer`	HTML/URLからPDFへの変換
`LicenseManager`	`IronPdf.License`	ライセンス管理
`GdPictureStatus`	例外	エラー処理

ドキュメント読み込み方法

GdPicture.NET SDK	IronPDF
`pdf.LoadFromFile(path, loadInMemory)`	`PdfDocument.FromFile(path)`
`pdf.LoadFromFile(path, password, loadInMemory)`	`PdfDocument.FromFile(path, password)`
`converter.LoadFromHTMLString(html)`	`renderer.RenderHtmlAsPdf(html)`
`converter.LoadFromURL(url)`	`renderer.RenderUrlAsPdf(url)`

ページ操作

GdPicture.NET SDK	IronPDF
`pdf.GetPageCount()`	`pdf.PageCount`
`pdf.SelectPage(pageNo)`	`pdf.Pages[index]`
`pdf.GetPageWidth()`	`pdf.Pages[i].Width`
`pdf.GetPageHeight()`	`pdf.Pages[i].Height`

マージと分割の操作

GdPicture.NET SDK	IronPDF
`pdf1.MergePages(pdf2)`	`PdfDocument.Merge(pdf1, pdf2)`
`pdf.ExtractPages(start, end)`	`pdf.CopyPages(indices)`

ウォーターマークの操作

GdPicture.NET SDK	IronPDF
`pdf.DrawText(...)` ループ	`pdf.ApplyWatermark(html)`
`pdf.SetTextColor(color)`	CSSスタイリング
`pdf.SetTextSize(size)`	CSSスタイリング

コード移行の例

例1: HTMLからPDFへの変換

以前(GdPicture.NET SDK)：。

// NuGet: Install-Package GdPicture.NET
using GdPicture14;
using System;

class Program
{
    static void Main()
    {
        using (GdPictureDocumentConverter converter = new GdPictureDocumentConverter())
        {
            string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
            GdPictureStatus status = converter.LoadFromHTMLString(htmlContent);

            if (status == GdPictureStatus.OK)
            {
                converter.SaveAsPDF("output.pdf");
            }
        }
    }
}

// NuGet: Install-Package GdPicture.NET
using GdPicture14;
using System;

class Program
{
    static void Main()
    {
        using (GdPictureDocumentConverter converter = new GdPictureDocumentConverter())
        {
            string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
            GdPictureStatus status = converter.LoadFromHTMLString(htmlContent);

            if (status == GdPictureStatus.OK)
            {
                converter.SaveAsPDF("output.pdf");
            }
        }
    }
}

Imports GdPicture14
Imports System

Class Program
    Shared Sub Main()
        Using converter As New GdPictureDocumentConverter()
            Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"
            Dim status As GdPictureStatus = converter.LoadFromHTMLString(htmlContent)

            If status = GdPictureStatus.OK Then
                converter.SaveAsPDF("output.pdf")
            End If
        End Using
    End Sub
End Class

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

IronPDF の ChromePdfRenderer は、最新の Chromium エンジンを使用して正確な HTML/CSS レンダリングを実現し、ステータスコードのチェックの必要性を排除します。 HTMLレンダリングのオプションについては、HTML to PDF documentationを参照してください。

例2: 複数のPDFをマージする

以前(GdPicture.NET SDK)：。

// NuGet: Install-Package GdPicture.NET
using GdPicture14;
using System;

class Program
{
    static void Main()
    {
        using (GdPicturePDF pdf1 = new GdPicturePDF())
        using (GdPicturePDF pdf2 = new GdPicturePDF())
        {
            pdf1.LoadFromFile("document1.pdf", false);
            pdf2.LoadFromFile("document2.pdf", false);

            pdf1.MergePages(pdf2);
            pdf1.SaveToFile("merged.pdf");
        }
    }
}

// NuGet: Install-Package GdPicture.NET
using GdPicture14;
using System;

class Program
{
    static void Main()
    {
        using (GdPicturePDF pdf1 = new GdPicturePDF())
        using (GdPicturePDF pdf2 = new GdPicturePDF())
        {
            pdf1.LoadFromFile("document1.pdf", false);
            pdf2.LoadFromFile("document2.pdf", false);

            pdf1.MergePages(pdf2);
            pdf1.SaveToFile("merged.pdf");
        }
    }
}

Imports GdPicture14
Imports System

Class Program
    Shared Sub Main()
        Using pdf1 As New GdPicturePDF(), pdf2 As New GdPicturePDF()
            pdf1.LoadFromFile("document1.pdf", False)
            pdf2.LoadFromFile("document2.pdf", False)

            pdf1.MergePages(pdf2)
            pdf1.SaveToFile("merged.pdf")
        End Using
    End Sub
End Class

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

// NuGet: Install-Package IronPdf
using IronPdf;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");

        var merged = PdfDocument.Merge(new List<PdfDocument> { pdf1, pdf2 });
        merged.SaveAs("merged.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");

        var merged = PdfDocument.Merge(new List<PdfDocument> { pdf1, pdf2 });
        merged.SaveAs("merged.pdf");
    }
}

Imports IronPdf
Imports System.Collections.Generic

Class Program
    Shared Sub Main()
        Dim pdf1 = PdfDocument.FromFile("document1.pdf")
        Dim pdf2 = PdfDocument.FromFile("document2.pdf")

        Dim merged = PdfDocument.Merge(New List(Of PdfDocument) From {pdf1, pdf2})
        merged.SaveAs("merged.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

IronPDF の静的 Merge メソッドはドキュメントのリストを受け入れるため、1 回の操作で複数の PDF を簡単に結合できます。 PDFのマージと分割については、こちらをご覧ください。

例3: すべてのページに透かしを追加する

以前(GdPicture.NET SDK)：。

// NuGet: Install-Package GdPicture.NET
using GdPicture14;
using System;
using System.Drawing;

class Program
{
    static void Main()
    {
        using (GdPicturePDF pdf = new GdPicturePDF())
        {
            pdf.LoadFromFile("input.pdf", false);

            for (int i = 1; i <= pdf.GetPageCount(); i++)
            {
                pdf.SelectPage(i);
                pdf.SetTextColor(Color.Red);
                pdf.SetTextSize(48);
                pdf.DrawText("CONFIDENTIAL", 200, 400);
            }

            pdf.SaveToFile("watermarked.pdf");
        }
    }
}

// NuGet: Install-Package GdPicture.NET
using GdPicture14;
using System;
using System.Drawing;

class Program
{
    static void Main()
    {
        using (GdPicturePDF pdf = new GdPicturePDF())
        {
            pdf.LoadFromFile("input.pdf", false);

            for (int i = 1; i <= pdf.GetPageCount(); i++)
            {
                pdf.SelectPage(i);
                pdf.SetTextColor(Color.Red);
                pdf.SetTextSize(48);
                pdf.DrawText("CONFIDENTIAL", 200, 400);
            }

            pdf.SaveToFile("watermarked.pdf");
        }
    }
}

Imports GdPicture14
Imports System
Imports System.Drawing

Module Program
    Sub Main()
        Using pdf As New GdPicturePDF()
            pdf.LoadFromFile("input.pdf", False)

            For i As Integer = 1 To pdf.GetPageCount()
                pdf.SelectPage(i)
                pdf.SetTextColor(Color.Red)
                pdf.SetTextSize(48)
                pdf.DrawText("CONFIDENTIAL", 200, 400)
            Next

            pdf.SaveToFile("watermarked.pdf")
        End Using
    End Sub
End Module

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");

        pdf.ApplyWatermark("<h1 style='color:red;'>CONFIDENTIAL</h1>", 50, VerticalAlignment.Middle, HorizontalAlignment.Center);

        pdf.SaveAs("watermarked.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");

        pdf.ApplyWatermark("<h1 style='color:red;'>CONFIDENTIAL</h1>", 50, VerticalAlignment.Middle, HorizontalAlignment.Center);

        pdf.SaveAs("watermarked.pdf");
    }
}

Imports IronPdf
Imports IronPdf.Editing

Class Program
    Shared Sub Main()
        Dim pdf = PdfDocument.FromFile("input.pdf")

        pdf.ApplyWatermark("<h1 style='color:red;'>CONFIDENTIAL</h1>", 50, VerticalAlignment.Middle, HorizontalAlignment.Center)

        pdf.SaveAs("watermarked.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

GdPicture.NET SDKは、座標ベースのテキスト描画からHTMLベースの電子透かしへの移行により、コードを大幅に簡素化します。IronPDFの ApplyWatermark メソッドは HTML/CSS スタイルを使用するため、手動でのページの反復処理や座標計算が不要になります。その他のオプションについては、watermarking documentationの全文をご覧ください。

例4: パスワード保護とセキュリティ

以前(GdPicture.NET SDK)：。

using GdPicture14;

class Program
{
    static void Main()
    {
        LicenseManager.RegisterKEY("LICENSE-KEY");

        using (GdPicturePDF pdf = new GdPicturePDF())
        {
            GdPictureStatus status = pdf.LoadFromFile("document.pdf", false);

            if (status != GdPictureStatus.OK) return;

            // Save with encryption - many boolean parameters
            status = pdf.SaveToFile(
                "protected.pdf",
                PdfEncryption.PdfEncryption256BitAES,
                "user123",      // User password
                "owner456",     // Owner password
                true,           // Can print
                false,          // Cannot copy
                false,          // Cannot modify
                false,          // Cannot add notes
                true,           // Can fill forms
                false,          // Cannot extract
                false,          // Cannot assemble
                true            // Can print high quality
            );
        }
    }
}

using GdPicture14;

class Program
{
    static void Main()
    {
        LicenseManager.RegisterKEY("LICENSE-KEY");

        using (GdPicturePDF pdf = new GdPicturePDF())
        {
            GdPictureStatus status = pdf.LoadFromFile("document.pdf", false);

            if (status != GdPictureStatus.OK) return;

            // Save with encryption - many boolean parameters
            status = pdf.SaveToFile(
                "protected.pdf",
                PdfEncryption.PdfEncryption256BitAES,
                "user123",      // User password
                "owner456",     // Owner password
                true,           // Can print
                false,          // Cannot copy
                false,          // Cannot modify
                false,          // Cannot add notes
                true,           // Can fill forms
                false,          // Cannot extract
                false,          // Cannot assemble
                true            // Can print high quality
            );
        }
    }
}

Imports GdPicture14

Class Program
    Shared Sub Main()
        LicenseManager.RegisterKEY("LICENSE-KEY")

        Using pdf As New GdPicturePDF()
            Dim status As GdPictureStatus = pdf.LoadFromFile("document.pdf", False)

            If status <> GdPictureStatus.OK Then Return

            ' Save with encryption - many boolean parameters
            status = pdf.SaveToFile(
                "protected.pdf",
                PdfEncryption.PdfEncryption256BitAES,
                "user123",      ' User password
                "owner456",     ' Owner password
                True,           ' Can print
                False,          ' Cannot copy
                False,          ' Cannot modify
                False,          ' Cannot add notes
                True,           ' Can fill forms
                False,          ' Cannot extract
                False,          ' Cannot assemble
                True            ' Can print high quality
            )
        End Using
    End Sub
End Class

$vbLabelText $csharpLabel

翻訳後(IronPDF)：。

using IronPdf;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("document.pdf");

        // Configure security settings with clear property names
        pdf.SecuritySettings.OwnerPassword = "owner456";
        pdf.SecuritySettings.UserPassword = "user123";

        // Set permissions
        pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
        pdf.SecuritySettings.AllowUserCopyPasteContent = false;
        pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit;
        pdf.SecuritySettings.AllowUserAnnotations = false;
        pdf.SecuritySettings.AllowUserFormData = true;

        pdf.SaveAs("protected.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("document.pdf");

        // Configure security settings with clear property names
        pdf.SecuritySettings.OwnerPassword = "owner456";
        pdf.SecuritySettings.UserPassword = "user123";

        // Set permissions
        pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
        pdf.SecuritySettings.AllowUserCopyPasteContent = false;
        pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit;
        pdf.SecuritySettings.AllowUserAnnotations = false;
        pdf.SecuritySettings.AllowUserFormData = true;

        pdf.SaveAs("protected.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim pdf = PdfDocument.FromFile("document.pdf")

        ' Configure security settings with clear property names
        pdf.SecuritySettings.OwnerPassword = "owner456"
        pdf.SecuritySettings.UserPassword = "user123"

        ' Set permissions
        pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights
        pdf.SecuritySettings.AllowUserCopyPasteContent = False
        pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit
        pdf.SecuritySettings.AllowUserAnnotations = False
        pdf.SecuritySettings.AllowUserFormData = True

        pdf.SaveAs("protected.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

IronPDF の SecuritySettings プロパティは、位置ブールパラメータの代わりに、名前付きの自己文書化プロパティを提供します。

重要な移行に関する注意事項

ページインデックス変換

このGdPicture.NET SDKの移行における最も重要な変更点の1つは、ページインデックスの違いです：

// GdPicture.NET SDK:1-indexedpages
for (int i = 1; i <= pdf.GetPageCount(); i++)
{
    pdf.SelectPage(i);
    // process page
}

// IronPDF: 0-indexed pages (standard .NET)
for (int i = 0; i < pdf.PageCount; i++)
{
    var page = pdf.Pages[i];
    // process page
}

// GdPicture.NET SDK:1-indexedpages
for (int i = 1; i <= pdf.GetPageCount(); i++)
{
    pdf.SelectPage(i);
    // process page
}

// IronPDF: 0-indexed pages (standard .NET)
for (int i = 0; i < pdf.PageCount; i++)
{
    var page = pdf.Pages[i];
    // process page
}

Imports System

' GdPicture.NET SDK: 1-indexed pages
For i As Integer = 1 To pdf.GetPageCount()
    pdf.SelectPage(i)
    ' process page
Next

' IronPDF: 0-indexed pages (standard .NET)
For i As Integer = 0 To pdf.PageCount - 1
    Dim page = pdf.Pages(i)
    ' process page
Next

$vbLabelText $csharpLabel

ステータスコードから例外へ

冗長なステータスチェックを標準的な try-catch に置き換えてください：

// GdPicture.NET SDK
GdPictureStatus status = converter.LoadFromHTMLString(html);
if (status != GdPictureStatus.OK)
{
    Console.WriteLine($"Error: {status}");
    return;
}

// IronPDF
try
{
    var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}

// GdPicture.NET SDK
GdPictureStatus status = converter.LoadFromHTMLString(html);
if (status != GdPictureStatus.OK)
{
    Console.WriteLine($"Error: {status}");
    return;
}

// IronPDF
try
{
    var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}

' GdPicture.NET SDK
Dim status As GdPictureStatus = converter.LoadFromHTMLString(html)
If status <> GdPictureStatus.OK Then
    Console.WriteLine($"Error: {status}")
    Return
End If

' IronPDF
Try
    Dim pdf = renderer.RenderHtmlAsPdf(html)
    pdf.SaveAs("output.pdf")
Catch ex As Exception
    Console.WriteLine($"Error: {ex.Message}")
End Try

$vbLabelText $csharpLabel

ユニット変換

GdPicture.NET SDKは、余白にインチを使用しています； IronPDFはミリメートルを使用しています：

// GdPicture.NET SDK: 0.5 inches margin
converter.HtmlSetMargins(0.5f, 0.5f, 0.5f, 0.5f);

// IronPDF: 0.5 inches = 12.7 mm
renderer.RenderingOptions.MarginTop = 12.7;
renderer.RenderingOptions.MarginBottom = 12.7;
renderer.RenderingOptions.MarginLeft = 12.7;
renderer.RenderingOptions.MarginRight = 12.7;

// GdPicture.NET SDK: 0.5 inches margin
converter.HtmlSetMargins(0.5f, 0.5f, 0.5f, 0.5f);

// IronPDF: 0.5 inches = 12.7 mm
renderer.RenderingOptions.MarginTop = 12.7;
renderer.RenderingOptions.MarginBottom = 12.7;
renderer.RenderingOptions.MarginLeft = 12.7;
renderer.RenderingOptions.MarginRight = 12.7;

' GdPicture.NET SDK: 0.5 inches margin
converter.HtmlSetMargins(0.5F, 0.5F, 0.5F, 0.5F)

' IronPDF: 0.5 inches = 12.7 mm
renderer.RenderingOptions.MarginTop = 12.7
renderer.RenderingOptions.MarginBottom = 12.7
renderer.RenderingOptions.MarginLeft = 12.7
renderer.RenderingOptions.MarginRight = 12.7

$vbLabelText $csharpLabel

変換式: millimeters = inches × 25.4

スレッドの安全性

GdPicture.NET SDKは、同時処理に手動同期を必要とします。IronPDFの ChromePdfRenderer は設計上スレッドセーフであり、マルチスレッド PDF 生成を簡素化します。

パフォーマンスの考慮事項

ChromePdfRendererを再利用してください

最適なパフォーマンスを得るために、レンダラーのインスタンスを再利用してください：

// GOOD - Reuse renderer (thread-safe)
public class PdfService
{
    private static readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

    public byte[] Generate(string html) => _renderer.RenderHtmlAsPdf(html).BinaryData;
}

// BAD - Creates new instance each time
public byte[] GenerateBad(string html)
{
    var renderer = new ChromePdfRenderer();  // Wasteful
    return renderer.RenderHtmlAsPdf(html).BinaryData;
}

// GOOD - Reuse renderer (thread-safe)
public class PdfService
{
    private static readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

    public byte[] Generate(string html) => _renderer.RenderHtmlAsPdf(html).BinaryData;
}

// BAD - Creates new instance each time
public byte[] GenerateBad(string html)
{
    var renderer = new ChromePdfRenderer();  // Wasteful
    return renderer.RenderHtmlAsPdf(html).BinaryData;
}

Imports System

Public Class PdfService
    Private Shared ReadOnly _renderer As New ChromePdfRenderer()

    Public Function Generate(html As String) As Byte()
        Return _renderer.RenderHtmlAsPdf(html).BinaryData
    End Function

    ' BAD - Creates new instance each time
    Public Function GenerateBad(html As String) As Byte()
        Dim renderer As New ChromePdfRenderer() ' Wasteful
        Return renderer.RenderHtmlAsPdf(html).BinaryData
    End Function
End Class

$vbLabelText $csharpLabel

適切なリソースの処分

// Use using statements for automatic cleanup
using (var pdf = PdfDocument.FromFile("large.pdf"))
{
    string text = pdf.ExtractAllText();
}  // pdf is disposed automatically

// Use using statements for automatic cleanup
using (var pdf = PdfDocument.FromFile("large.pdf"))
{
    string text = pdf.ExtractAllText();
}  // pdf is disposed automatically

Imports PdfDocument

' Use Using blocks for automatic cleanup
Using pdf = PdfDocument.FromFile("large.pdf")
    Dim text As String = pdf.ExtractAllText()
End Using ' pdf is disposed automatically

$vbLabelText $csharpLabel

移行チェックリスト

移行前

コードベース内のすべての GdPicture .NET SDK の使用状況をインベントリします
実際に使用されている機能を特定する(PDF vsOCRvs バーコード)
OCR/バーコード機能が必要かどうかを判断する( IronOCR/ IronBarcodeを検討)
現在のライセンスを確認し、IronPDFの価格と比較します
IronPDFライセンスキーを取得する
バージョン管理に移行ブランチを作成する

コードの移行

GdPicture .NET SDK NuGetパッケージを削除します: dotnet remove package GdPicture.NET -IronPDFNuGetパッケージをインストールします: dotnet add package IronPdf
名前空間のインポートを更新します (GdPicture14 → IronPdf)
LicenseManager.RegisterKEY() を IronPdf.License.LicenseKey に置き換えます
ステータスコードチェックをtry-catchブロックに変換する
ページのインデックスを更新(1 からインデックス → 0 からインデックス)
GdPicturePDF を PdfDocument に置き換えます
GdPictureDocumentConverter を ChromePdfRenderer に置き換えます
座標ベースのテキストをHTMLスタンプに変換する
単位変換を更新（インチ → ミリメートル）

テスティング

すべてのPDF生成パスをユニットテストする
HTMLレンダリング品質が一致または超過していることを確認する
すべてのセキュリティ/暗号化シナリオをテストする
フォーム入力機能を確認する
マージ/分割操作をテストする
透かしの外観を検証する
パフォーマンスベンチマークのクリティカルパス

移行後

GdPicture .NET SDK ライセンスファイル/キーを削除します
ドキュメントの更新 -IronPDFAPIパターンについてチームをトレーニングする
問題がないか生産状況を監視

カーティス・チャウ

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

テクニカルライター

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

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

30日間無料トライアルを開始

C#でGdPicture.NET SDKからIronPDFに移行する方法

GdPicture.NETSDKからIronPDFへ移行する理由

GdPicture.NETのSDKの課題

GdPicture.NETSDKとIronPDFの比較

マイグレーションの複雑さの評価

機能別の見積もり作業

移行の決定マトリックス

始める前に

前提条件

すべてのGdPicture.NET SDKの使用法を特定する

NuGetパッケージの変更

クイック スタート マイグレーション

ステップ 1: ライセンス構成の更新

ステップ 2: 名前空間インポートを更新する

ステップ 3: 基本的な変換パターン

完全な API リファレンス

名前空間マッピング

コア クラス マッピング

ドキュメント読み込み方法

ページ操作

マージと分割の操作

ウォーターマークの操作

コード移行の例

例1: HTMLからPDFへの変換

例2: 複数のPDFをマージする

例3: すべてのページに透かしを追加する

例4: パスワード保護とセキュリティ

重要な移行に関する注意事項

ページインデックス変換

ステータス コードから例外へ

ユニット変換

スレッドの安全性

パフォーマンスの考慮事項

ChromePdfRendererを再利用してください

適切なリソースの処分

移行チェックリスト

移行前

コードの移行

テスティング

移行後

関連する記事

C#でZetPDFからIronPDFに移行する方法

C#でScryber.CoreからIronPDFに移行する方法

C#でXFINIUM.PDFからIronPDFへ移行する方法

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

世界中の数百万人のエンジニアから信頼されています。

アイアンサポートチーム

クイックスタートマイグレーション

コアクラスマッピング

ステータスコードから例外へ