Cefsharp.WPF.NET Core (開発者向けの仕組み)

CefSharpの重要性

CefSharpは、Chromiumのウェブブラウザーエンジンの威力を.NETアプリケーションに容易に統合することで、開発者がデスクトップアプリや自動化プロジェクトの構築方法を変革するフレームワークです。 CefSharpを使用することで、HTML5サポートを活用した埋め込みUIを含むリモートウェブコンテンツを表示することができます。

CefSharpの紹介で強調すべき重要な点は次のとおりです：

• Chromium Embedded Framework（CEF）はCefSharpの基礎となるフレームワークであり、Chromiumブラウザーの機能を他のプログラムに統合できるようにします。 GoogleのChromiumプロジェクトを使用することで、CefSharpはデスクトッププログラムに高度なウェブ機能をもたらします。
• .NET統合：CefSharpはCefのための強力な.NETラッパーです。 プログラマーがC#や他 for .NET言語を使用して高速ウェブブラウザーをデスクトップ.NETアプリケーションに統合することを容易にします。
• デスクトップアプリにおけるウェブサーフィン：CefSharpを使えば、開発者は簡単にウェブブラウジング機能をデスクトッププログラムに組み込むことができます。 この機能により、開発者はユーザーインターフェースにオンライン資料を組み込んだり、ウェブ対応の独自のデスクトップアプリを作成する可能性が広がります。 JavaScriptイベントが発生するときにコールバックを受け取ることができます。
• 豊富なウェブ技術のサポート：CefSharpを使用することで、開発者はChromiumが提供する全ての機能を活用することができます。HTML5、CSS3、JavaScript、WebGLなど、最新のウェブ標準を含む最新のウェブ技術をサポートしています。 これにより、デスクトッププログラムに先端ウェブ技術を取り入れることが可能になります。
• 柔軟性とカスタマイズ：CefSharpは開発者に多くの柔軟性とカスタマイズの可能性を提供し、イベントを処理し、JavaScriptを実行し、オンラインコンテンツと相互作用し、特定のアプリケーションニーズに応じてブラウザ動作を変更することができます。 CefSharp with WebGLは、ハードウェアアクセラレーションによるレンダリングのためにOpenGL/DirectXを利用し、3Dコンテンツをサポートします。

CefSharpを使用することで、開発者はデスクトップアプリケーションを改善し、ウェブサーフィン体験を促進し、アプリケーション環境内でユーザーに豊かで現代的な情報を提供することができます。

サンプルコード:

using System;
using System.Windows.Forms;
using CefSharp;
using CefSharp.WinForms;

namespace CefSharpExample
{
    public partial class MainForm : Form
    {
        private ChromiumWebBrowser chromeBrowser;

        public MainForm()
        {
            InitializeComponent();

            // Initialize CefSharp settings
            CefSettings settings = new CefSettings();
            Cef.Initialize(settings);

            // Create the ChromiumWebBrowser instance
            chromeBrowser = new ChromiumWebBrowser("https://ironpdf.com/"); // Load a URL

            // Add the ChromiumWebBrowser control to the form
            this.Controls.Add(chromeBrowser);
            chromeBrowser.Dock = DockStyle.Fill; // Fill the entire form

            // Handle when the browser component has finished loading
            chromeBrowser.LoadingStateChanged += ChromeBrowser_LoadingStateChanged;
        }

        private void ChromeBrowser_LoadingStateChanged(object sender, LoadingStateChangedEventArgs e)
        {
            if (!e.IsLoading)
            {
                // Page has finished loading
                // Perform actions after the page has loaded
                Console.WriteLine("Finished loading.");
            }
        }

        // Dispose of Cef resources when the form is closed
        private void MainForm_FormClosing(object sender, FormClosingEventArgs e)
        {
            Cef.Shutdown();
        }
    }
}

using System;
using System.Windows.Forms;
using CefSharp;
using CefSharp.WinForms;

namespace CefSharpExample
{
    public partial class MainForm : Form
    {
        private ChromiumWebBrowser chromeBrowser;

        public MainForm()
        {
            InitializeComponent();

            // Initialize CefSharp settings
            CefSettings settings = new CefSettings();
            Cef.Initialize(settings);

            // Create the ChromiumWebBrowser instance
            chromeBrowser = new ChromiumWebBrowser("https://ironpdf.com/"); // Load a URL

            // Add the ChromiumWebBrowser control to the form
            this.Controls.Add(chromeBrowser);
            chromeBrowser.Dock = DockStyle.Fill; // Fill the entire form

            // Handle when the browser component has finished loading
            chromeBrowser.LoadingStateChanged += ChromeBrowser_LoadingStateChanged;
        }

        private void ChromeBrowser_LoadingStateChanged(object sender, LoadingStateChangedEventArgs e)
        {
            if (!e.IsLoading)
            {
                // Page has finished loading
                // Perform actions after the page has loaded
                Console.WriteLine("Finished loading.");
            }
        }

        // Dispose of Cef resources when the form is closed
        private void MainForm_FormClosing(object sender, FormClosingEventArgs e)
        {
            Cef.Shutdown();
        }
    }
}

このコードは、Chromiumをベースにした埋め込みウェブブラウザーを持つ基本的なWinFormsアプリケーションを開発するためにCefSharpを使用します。 説明はこちらです：

• CefSettings を使用して CefSharp 設定を初期化します。
• ChromiumWebBrowser：このクラスはCefSharpが提供するウェブブラウザーコントロールを表します。
• LoadingStateChanged イベントは、ページの読み込みが完了したときなど、ブラウザの読み込み状態の変化を処理します。
• MainForm_FormClosing イベントは、フォームが閉じられたときに Cef リソースが適切にシャットダウンされることを保証します。

基本的な例については、CefSharpを使用してコンパイル準備が整ったアプリをMinimal Example Project on GitHubで確認できます。 より複雑な例プロジェクトはプロジェクトのソースで利用可能です。

IronPDFをインストールする

IronPDFライブラリを取得するには、今後のステップに従ってください。 パッケージマネージャーに以下のコードを入力してください：

Install-Package IronPdf 
dotnet add package IronPdf

Install-Package IronPdf 
dotnet add package IronPdf

代替として、NuGetパッケージマネージャーを使用して"IronPDF"パッケージを検索することができます。 IronPDFに関連するすべてのNuGetパッケージのリストから、必要なパッケージを選択してダウンロードしてください。

Using IronPDF in CefSharp C

C#アプリケーションでIronPDFをCefSharpと統合するには、2つのステップを実行する必要があります：CefSharpが提供するChromiumベースのブラウザを使用してHTMLコンテンツをレンダリングし、その後、IronPDFを使用してそのHTML情報をPDFドキュメントに変換します。 次の例は、この統合を達成する方法を示しています：

using CefSharp;
using IronPdf;
using System;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace CefSharpIronPdfIntegration
{
    public partial class MainForm : Form
    {
        private ChromiumWebBrowser chromeBrowser;

        public MainForm()
        {
            InitializeComponent();

            // Initialize CefSharp
            CefSettings settings = new CefSettings();
            Cef.Initialize(settings);

            // Create the ChromiumWebBrowser instance
            chromeBrowser = new ChromiumWebBrowser("https://ironpdf.com/"); // Load a URL

            // Add the ChromiumWebBrowser control to the form
            this.Controls.Add(chromeBrowser);
            chromeBrowser.Dock = DockStyle.Fill; // Fill the entire form

            // Handle when the browser component has finished loading
            chromeBrowser.LoadingStateChanged += ChromeBrowser_LoadingStateChanged;
        }

        private async void ChromeBrowser_LoadingStateChanged(object sender, LoadingStateChangedEventArgs e)
        {
            if (!e.IsLoading)
            {
                // Page has finished loading
                // Capture HTML content after page load completes
                string htmlContent = await chromeBrowser.GetSourceAsync();

                // Use IronPDF to generate a PDF from the captured HTML content
                var Renderer = new IronPdf.HtmlToPdf();
                var PDF = Renderer.RenderHtmlAsPdf(htmlContent);
                PDF.SaveAs("Output.pdf"); // Save the generated PDF

                Console.WriteLine("PDF generated successfully.");
            }
        }

        // Dispose of Cef resources when the form is closed to avoid unnecessary memory usage
        private void MainForm_FormClosing(object sender, FormClosingEventArgs e)
        {
            Cef.Shutdown();
        }
    }
}

using CefSharp;
using IronPdf;
using System;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace CefSharpIronPdfIntegration
{
    public partial class MainForm : Form
    {
        private ChromiumWebBrowser chromeBrowser;

        public MainForm()
        {
            InitializeComponent();

            // Initialize CefSharp
            CefSettings settings = new CefSettings();
            Cef.Initialize(settings);

            // Create the ChromiumWebBrowser instance
            chromeBrowser = new ChromiumWebBrowser("https://ironpdf.com/"); // Load a URL

            // Add the ChromiumWebBrowser control to the form
            this.Controls.Add(chromeBrowser);
            chromeBrowser.Dock = DockStyle.Fill; // Fill the entire form

            // Handle when the browser component has finished loading
            chromeBrowser.LoadingStateChanged += ChromeBrowser_LoadingStateChanged;
        }

        private async void ChromeBrowser_LoadingStateChanged(object sender, LoadingStateChangedEventArgs e)
        {
            if (!e.IsLoading)
            {
                // Page has finished loading
                // Capture HTML content after page load completes
                string htmlContent = await chromeBrowser.GetSourceAsync();

                // Use IronPDF to generate a PDF from the captured HTML content
                var Renderer = new IronPdf.HtmlToPdf();
                var PDF = Renderer.RenderHtmlAsPdf(htmlContent);
                PDF.SaveAs("Output.pdf"); // Save the generated PDF

                Console.WriteLine("PDF generated successfully.");
            }
        }

        // Dispose of Cef resources when the form is closed to avoid unnecessary memory usage
        private void MainForm_FormClosing(object sender, FormClosingEventArgs e)
        {
            Cef.Shutdown();
        }
    }
}

このコードは、Chromiumブラウザーで読み込むHTMLコンテンツをインターセプトし、IronPDFを使用してそれをPDFドキュメントに変換するという単純な統合を示しています。 説明はこちらです：

• CefSharpを初期化してChromiumブラウザーをWindows Formsアプリケーションに統合します。
• ChromiumWebBrowser コントロール: このコントロールは、特定の URL (この例では、"https://ironpdf.com/") をブラウザーに読み込み、そのインスタンスを作成します。
• LoadingStateChanged イベント: ブラウザの読み込みの進行状況を追跡します。 ページの読み込みが完了すると (e.IsLoading は false)、ChromeBrowser は GetSourceAsync() を使用して、読み込まれたページの HTML コンテンツを非同期的にキャプチャします。
• IronPDF統合: キャプチャされた HTML コンテンツ (htmlContent) は、IronPDF の HtmlToPdf 機能を使用して PDF ドキュメントに変換されます。 生成されたPDFは"Output.pdf"として保存されます。
• フォームのクローズ: フォームが閉じられた後、Cef.Shutdown() を呼び出して、Cef リソースが適切にシャットダウンされていることを確認します。

このコードは、Chromiumブラウザーで読み込むHTMLコンテンツをインターセプトし、その後IronPDFを使用してそれをPDFドキュメントに変換するという単純な統合を示しています。 URL、エラー処理、および他の側面をアプリケーションの特定のニーズに合わせてカスタマイズしてください。 IronPDFドキュメンテーションの詳細については、IronPDF NuGet Packageをご参照ください。