Cefsharp.WPF.NET Core (Cómo funciona para desarrolladores)

Importancia de CefSharp

CefSharp es un marco que transforma la forma en que los desarrolladores construyen aplicaciones de escritorio y proyectos de automatización con capacidades de navegación web integradas al integrar sin esfuerzo el poder del motor de navegador web de Chromium en aplicaciones .NET. Con la ayuda de CefSharp, podemos mostrar contenido web remoto, incluyendo interfaces de usuario integradas con soporte para HTML5.

Aspectos importantes a enfatizar en una introducción a CefSharp son:

• El Chromium Embedded Framework (CEF) sirve como el marco para CefSharp, permitiendo la integración de las características del navegador Chromium en otros programas. Usando el proyecto Chromium de Google, CefSharp mejora los programas de escritorio con características web sofisticadas.
• Integración .NET: CefSharp es un potente contenedor .NET para Cef. Facilita a los programadores el uso de C# u otros lenguajes .NET para integrar un navegador web rápido en sus aplicaciones de escritorio .NET.
• Navegación web en Aplicaciones de Escritorio: Con CefSharp, los desarrolladores pueden incorporar fácilmente características de navegación web en sus programas de escritorio. Esta característica abre un mundo de posibilidades para los desarrolladores, permitiéndoles incorporar material en línea en sus interfaces de usuario o crear aplicaciones de escritorio únicas que estén habilitadas para la web. Puede recibir un callback cuando se disparen eventos de JavaScript.
• Soporte para Tecnologías Web Ricas: Al usar CefSharp, los desarrolladores pueden aprovechar todas las capacidades que Chromium ofrece, incluyendo soporte para los estándares web más nuevos como HTML5, CSS3, JavaScript, WebGL y otros estándares web modernos. Esto hace posible incluir tecnologías web de vanguardia en programas de escritorio.
• Flexibilidad y Personalización: CefSharp proporciona a los desarrolladores una gran cantidad de flexibilidad y opciones de personalización, permitiéndoles manejar eventos, ejecutar JavaScript, interactuar con contenido en línea y modificar el comportamiento del navegador para satisfacer necesidades específicas de la aplicación. CefSharp con WebGL, que utiliza OpenGL/DirectX para el renderizado acelerado por hardware, soporta contenido 3D.

Mediante el uso de CefSharp, los desarrolladores pueden mejorar las aplicaciones de escritorio facilitando experiencias de navegación web, alentando la interacción del usuario y proporcionando a los usuarios información rica y moderna dentro del entorno de la aplicación.

Código de Ejemplo:

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

Este código usa CefSharp para desarrollar una aplicación básica de WinForms con un navegador web integrado basado en Chromium. Aquí hay una explicación:

• Inicializar la configuración de CefSharp usando CefSettings.
• ChromiumWebBrowser: Esta clase representa el control de navegador web proporcionado por CefSharp.
• El evento LoadingStateChanged maneja los cambios en el estado de carga del navegador, por ejemplo, cuando una página termina de cargar.
• El evento MainForm_FormClosing asegura que los recursos de Cef se apaguen correctamente al cerrar el formulario.

Para un ejemplo básico, se pueden ver las aplicaciones construidas usando CefSharp que están listas para compilar en el Proyecto de Ejemplo Mínimo en GitHub. Proyectos de ejemplo más complicados están disponibles en la fuente del proyecto.

Instalar IronPDF

Para adquirir la biblioteca IronPDF, necesitas seguir los siguientes pasos. Introduce el siguiente código en el Administrador de Paquetes:

Install-Package IronPdf 
dotnet add package IronPdf

Install-Package IronPdf 
dotnet add package IronPdf

Alternativamente, puedes usar el Administrador de Paquetes NuGet para buscar el paquete "IronPDF". De la lista de todos los paquetes NuGet relacionados con IronPDF, elige y descarga el paquete necesario.

Uso de IronPDF en CefSharp C#

Para integrar IronPDF con CefSharp en una aplicación C#, necesitas realizar dos pasos: utilizar el navegador basado en Chromium proporcionado por CefSharp para renderizar contenido HTML y luego usar IronPDF para convertir esa información HTML en un documento PDF. El siguiente ejemplo demuestra cómo lograr esta integración:

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

Este código demuestra una integración simple donde el contenido HTML cargado en el navegador Chromium se intercepta, y se usa IronPDF para transformarlo en un documento PDF. Aquí hay una explicación:

• Inicializar CefSharp para integrar el navegador Chromium en una aplicación de Windows Forms.
• Control ChromiumWebBrowser: Este control carga una URL específica (en este ejemplo, "https://ironpdf.com/") en el navegador y crea una instancia de él.
• Evento LoadingStateChanged: Rastrear el progreso de carga del navegador. Cuando la página termina de cargar (e.IsLoading es falso), el ChromeBrowser captura asincrónicamente el contenido HTML de la página cargada usando GetSourceAsync().
• Integración de IronPDF: El contenido HTML capturado (htmlContent) se convierte en un documento PDF usando la capacidad HtmlToPdf de IronPDF. El PDF generado se guarda como "Output.pdf".
• Cierre del Formulario: Asegúrate de que los recursos de Cef se apaguen correctamente llamando a Cef.Shutdown() después de cerrar el formulario.

Este código demuestra una integración simple donde el contenido HTML cargado en el navegador Chromium es interceptado y luego convertido en un documento PDF usando IronPDF. Personaliza la URL, el manejo de errores y otros aspectos según las necesidades específicas de tu aplicación. Para más información sobre la documentación de IronPDF, por favor consulta el Paquete NuGet de IronPDF.