Cefsharp.WPF.NET Core (Fonctionnement Pour les Développeurs)

Importance de CefSharp

CefSharp est un framework qui transforme la façon dont les développeurs construisent des applications de bureau et des projets d'automatisation avec des capacités de navigation Web intégrées en intégrant sans effort la puissance du moteur de navigateur Web de Chromium dans les applications .NET. Avec l'aide de CefSharp, nous pouvons afficher du contenu Web distant, y compris une interface utilisateur intégrée avec support HTML5.

Les éléments importants à souligner dans une introduction à CefSharp sont :

• Le Chromium Embedded Framework (CEF) sert de cadre pour CefSharp, permettant l'intégration des fonctionnalités du navigateur Chromium dans d'autres programmes. En utilisant le projet Chromium de Google, CefSharp améliore les programmes de bureau avec des fonctionnalités Web sophistiquées.
• Intégration .NET : CefSharp est un puissant wrapper .NET pour Cef. Il facilite l'utilisation par les programmeurs de C# ou d'autres langages .NET pour intégrer un navigateur Web rapide dans leurs applications de bureau .NET.
• Navigation Web dans les applications de bureau : Avec CefSharp, les développeurs peuvent facilement intégrer des fonctionnalités de navigation Web dans leurs programmes de bureau. Cette fonctionnalité offre un monde de possibilités aux développeurs, leur permettant d'incorporer du matériel en ligne dans leurs interfaces utilisateur ou de créer des applications de bureau uniques compatibles Web. Il peut recevoir un rappel lorsque des événements JavaScript se déclenchent.
• Support des technologies Web riches : En utilisant CefSharp, les développeurs peuvent tirer parti de toutes les capacités offertes par Chromium, y compris le support des normes Web récentes comme HTML5, CSS3, JavaScript, WebGL et d'autres normes Web modernes. Cela permet d'inclure des technologies Web de pointe dans les programmes de bureau.
• Flexibilité et personnalisation : CefSharp offre aux développeurs une grande flexibilité et des possibilités de personnalisation, leur permettant de gérer les événements, d'exécuter du JavaScript, d'interagir avec le contenu en ligne et de modifier le comportement du navigateur pour répondre aux besoins spécifiques de l'application. CefSharp avec WebGL, qui utilise OpenGL/DirectX pour le rendu accéléré par matériel, prend en charge le contenu 3D.

Grâce à l'utilisation de CefSharp, les développeurs peuvent améliorer les applications de bureau en facilitant les expériences de navigation Web, en favorisant l'interaction utilisateur et en fournissant aux utilisateurs un contenu riche et moderne au sein de l'environnement de l'application.

Exemple de code :

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

Imports System
Imports System.Windows.Forms
Imports CefSharp
Imports CefSharp.WinForms

Namespace CefSharpExample
	Partial Public Class MainForm
		Inherits Form

		Private chromeBrowser As ChromiumWebBrowser

		Public Sub New()
			InitializeComponent()

			' Initialize CefSharp settings
			Dim settings As 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
			Me.Controls.Add(chromeBrowser)
			chromeBrowser.Dock = DockStyle.Fill ' Fill the entire form

			' Handle when the browser component has finished loading
			AddHandler chromeBrowser.LoadingStateChanged, AddressOf ChromeBrowser_LoadingStateChanged
		End Sub

		Private Sub ChromeBrowser_LoadingStateChanged(ByVal sender As Object, ByVal e As LoadingStateChangedEventArgs)
			If Not e.IsLoading Then
				' Page has finished loading
				' Perform actions after the page has loaded
				Console.WriteLine("Finished loading.")
			End If
		End Sub

		' Dispose of Cef resources when the form is closed
		Private Sub MainForm_FormClosing(ByVal sender As Object, ByVal e As FormClosingEventArgs)
			Cef.Shutdown()
		End Sub
	End Class
End Namespace

Ce code utilise CefSharp pour développer une application WinForms de base avec un navigateur Web intégré basé sur Chromium. Voici une explication :

• Initialisez les paramètres CefSharp en utilisant CefSettings.
• ChromiumWebBrowser : Cette classe représente le contrôle de navigateur Web fourni par CefSharp.
• L'événement LoadingStateChanged gère les changements d'état de chargement du navigateur, par exemple, lorsque la page finit de charger.
• L'événement MainForm_FormClosing garantit que les ressources Cef sont correctement fermées lors de la fermeture du formulaire.

Pour un exemple de base, consultez les applications construites utilisant CefSharp qui sont prêtes à être compilées dans le Projet d'exemple minimal sur GitHub. Des projets d'exemples plus complexes sont disponibles dans la source du projet.

Installer IronPDF

Pour obtenir la bibliothèque IronPDF, vous devez suivre les étapes à venir. Entrez le code suivant dans le gestionnaire de packages :

Install-Package IronPdf 
dotnet add package IronPdf

Install-Package IronPdf 
dotnet add package IronPdf

Alternativement, vous pouvez utiliser le gestionnaire de packages NuGet pour rechercher le package "IronPDF". Dans la liste de tous les packages NuGet liés à IronPDF, choisissez et téléchargez le package nécessaire.

Utiliser IronPDF dans CefSharp C#

Pour intégrer IronPDF avec CefSharp dans une application C#, vous devez effectuer deux étapes : utiliser le navigateur basé sur Chromium fourni par CefSharp pour rendre le contenu HTML, puis utiliser IronPDF pour convertir ces informations HTML en document PDF. L'exemple suivant montre comment réaliser cette intégration :

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

Imports CefSharp
Imports IronPdf
Imports System
Imports System.Threading.Tasks
Imports System.Windows.Forms

Namespace CefSharpIronPdfIntegration
	Partial Public Class MainForm
		Inherits Form

		Private chromeBrowser As ChromiumWebBrowser

		Public Sub New()
			InitializeComponent()

			' Initialize CefSharp
			Dim settings As 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
			Me.Controls.Add(chromeBrowser)
			chromeBrowser.Dock = DockStyle.Fill ' Fill the entire form

			' Handle when the browser component has finished loading
			AddHandler chromeBrowser.LoadingStateChanged, AddressOf ChromeBrowser_LoadingStateChanged
		End Sub

		Private Async Sub ChromeBrowser_LoadingStateChanged(ByVal sender As Object, ByVal e As LoadingStateChangedEventArgs)
			If Not e.IsLoading Then
				' Page has finished loading
				' Capture HTML content after page load completes
				Dim htmlContent As String = Await chromeBrowser.GetSourceAsync()

				' Use IronPDF to generate a PDF from the captured HTML content
				Dim Renderer = New IronPdf.HtmlToPdf()
				Dim PDF = Renderer.RenderHtmlAsPdf(htmlContent)
				PDF.SaveAs("Output.pdf") ' Save the generated PDF

				Console.WriteLine("PDF generated successfully.")
			End If
		End Sub

		' Dispose of Cef resources when the form is closed to avoid unnecessary memory usage
		Private Sub MainForm_FormClosing(ByVal sender As Object, ByVal e As FormClosingEventArgs)
			Cef.Shutdown()
		End Sub
	End Class
End Namespace

Ce code démontre une simple intégration où le contenu HTML chargé dans le navigateur Chromium est intercepté, et IronPDF est utilisé pour le transformer en document PDF. Voici une explication :

• Initialisez CefSharp pour intégrer le navigateur Chromium dans une application Windows Forms.
• Contrôle ChromiumWebBrowser : Ce contrôle charge une URL spécifique (dans cet exemple, "https://ironpdf.com/") dans le navigateur et en crée une instance.
• Événement LoadingStateChanged : Suit la progression du chargement du navigateur. Lorsque la page finit de charger (e.IsLoading est faux), le ChromeBrowser capture de manière asynchrone le contenu HTML de la page chargée en utilisant GetSourceAsync().
• Intégration IronPDF : Le contenu HTML capturé (htmlContent) est converti en document PDF en utilisant la fonctionnalité HtmlToPdf d'IronPDF. Le PDF généré est enregistré sous "Output.pdf".
• Fermeture du formulaire : Assurez-vous que les ressources Cef sont correctement fermées en appelant Cef.Shutdown() après la fermeture du formulaire.

Ce code démontre une simple intégration où le contenu HTML chargé dans le navigateur Chromium est intercepté puis converti en document PDF à l'aide d'IronPDF. Personnalisez l'URL, la gestion des erreurs et d'autres aspects selon les besoins spécifiques de votre application. Pour plus d'informations sur la documentation d'IronPDF, veuillez consulter le package NuGet IronPDF.