Cefsharp.WPF.NET Core (Como funciona para desenvolvedores)

Importância do CefSharp

CefSharp é um framework que transforma a maneira como os desenvolvedores criam aplicativos desktop e projetos de automação com recursos integrados de navegação na web, integrando facilmente o poder do mecanismo de navegador web Chromium em aplicativos .NET . Com a ajuda do CefSharp, podemos exibir conteúdo web remoto, incluindo interfaces de usuário incorporadas criadas com suporte a HTML5.

Pontos importantes a serem enfatizados em uma introdução ao CefSharp são:

• O Chromium Embedded Framework (CEF) serve como estrutura para o CefSharp, permitindo a integração dos recursos do navegador Chromium em outros programas. Ao utilizar o projeto Chromium do Google, o CefSharp aprimora programas de desktop com recursos sofisticados da web.
• Integração com .NET : CefSharp é um poderoso wrapper .NET para Cef. Isso facilita para os programadores usar C# ou outras linguagens .NET para integrar um navegador web rápido em seus aplicativos .NET para desktop.
• Navegação na Web em aplicativos de desktop: Com o CefSharp, os desenvolvedores podem incorporar facilmente recursos de navegação na Web em seus programas de desktop. Essa funcionalidade oferece um mundo de possibilidades para os desenvolvedores, permitindo que eles incorporem material online em suas interfaces de usuário ou criem aplicativos de desktop exclusivos que sejam compatíveis com a web. Ele pode receber uma função de retorno quando eventos JavaScript são acionados.
• Suporte a tecnologias web avançadas: Ao usar o CefSharp, os desenvolvedores podem aproveitar todos os recursos que o Chromium oferece, incluindo suporte aos padrões web mais recentes, como HTML5, CSS3, JavaScript, WebGL e outros padrões web modernos. Isso possibilita a inclusão de tecnologias web de ponta em programas para desktop. Flexibilidade e personalização: O CefSharp oferece aos desenvolvedores grande flexibilidade e possibilidades de personalização, permitindo que eles manipulem eventos, executem JavaScript, interajam com conteúdo online e modifiquem o comportamento do navegador para atender às necessidades específicas da aplicação. O CefSharp com WebGL, que utiliza OpenGL/DirectX para renderização acelerada por hardware, suporta conteúdo 3D.

Por meio do uso do CefSharp, os desenvolvedores podem aprimorar aplicativos de desktop, facilitando a experiência de navegação na web, incentivando a interação do usuário e fornecendo informações ricas e atualizadas dentro do ambiente do aplicativo.

Código de exemplo:

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 utiliza o CefSharp para desenvolver uma aplicação WinForms básica com um navegador web incorporado baseado no Chromium. Segue uma explicação:

• Inicialize as configurações do CefSharp usando CefSettings.
• ChromiumWebBrowser: Esta classe representa o controle do navegador web fornecido pelo CefSharp. O evento LoadingStateChanged lida com as mudanças no estado de carregamento do navegador, por exemplo, quando uma página termina de carregar. O evento MainForm_FormClosing garante que os recursos do Cef sejam devidamente desativados após o fechamento do formulário.

Para um exemplo básico, veja o Projeto de Exemplo Mínimo no GitHub , com aplicativos criados usando CefSharp que já podem ser compilados. Exemplos de projetos mais complexos estão disponíveis no código-fonte do projeto.

Instale o IronPDF

Para obter a biblioteca IronPDF , você precisa seguir os próximos passos. Insira o seguinte código no Gerenciador de Pacotes:

Install-Package IronPdf 
dotnet add package IronPdf

Install-Package IronPdf 
dotnet add package IronPdf

Alternativamente, você pode usar o Gerenciador de Pacotes NuGet para procurar o pacote "IronPDF". Na lista de todos os pacotes NuGet relacionados ao IronPDF, escolha e baixe o pacote necessário.

Usando o IronPDF no CefSharp em C

Para integrar o IronPDF com o CefSharp em uma aplicação C#, você precisa realizar duas etapas: utilizar o navegador baseado no Chromium fornecido pelo CefSharp para renderizar o conteúdo HTML e, em seguida, usar o IronPDF para converter essas informações HTML em um documento PDF. O exemplo a seguir demonstra como realizar essa integração:

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 demonstra uma integração simples onde o conteúdo HTML carregado no navegador Chromium é interceptado e o IronPDF é usado para transformá-lo em um documento PDF. Eis uma explicação:

• Inicialize o CefSharp para integrar o navegador Chromium em um aplicativo Windows Forms.
• ChromiumWebBrowser Controle: Este controle carrega uma URL específica (neste exemplo, "https://ironpdf.com/") no navegador e cria uma instância dela.
• LoadingStateChanged Evento: Monitora o progresso de carregamento do navegador. Quando a página termina de carregar (e.IsLoading é falso), o ChromeBrowser captura de forma assíncrona o conteúdo HTML da página carregada usando GetSourceAsync().
• Integração com IronPDF : O conteúdo HTML capturado (htmlContent) é convertido em um documento PDF usando o recurso HtmlToPdf do IronPDF. O PDF gerado é salvo como "Output.pdf".
• Encerramento do formulário: Certifique-se de que os recursos do Cef sejam devidamente encerrados chamando Cef.Shutdown() após o fechamento do formulário.

Este código demonstra uma integração simples onde o conteúdo HTML carregado no navegador Chromium é interceptado e então convertido em um documento PDF usando o IronPDF. Personalize o URL, o tratamento de erros e outros aspectos de acordo com as necessidades específicas da sua aplicação. Para obter mais informações sobre a documentação do IronPDF , consulte o pacote NuGet do IronPDF .