Cefsharp.WPF..NET Core (jak to działa dla programistów)

Znaczenie CefSharp

CefSharp to framework, który zmienia sposób, w jaki programiści tworzą aplikacje desktopowe i projekty automatyzacji z wbudowanymi funkcjami przeglądania stron internetowych, płynnie integrując możliwości silnika przeglądarki Chromium z aplikacjami .NET Framework. Dzięki CefSharp możemy wyświetlać zdalne treści internetowe, w tym osadzony interfejs użytkownika zbudowany z obsługą HTML5.

Ważne kwestie, na które należy zwrócić uwagę we wstępie do CefSharp, to:

• Chromium Embedded Framework (CEF) służy jako framework dla CefSharp, umożliwiając integrację funkcji przeglądarki Chromium z innymi programami. Wykorzystując projekt Chromium firmy Google, CefSharp wzbogaca programy desktopowe o zaawansowane funkcje internetowe.
• Integracja z .NET: CefSharp to potężna nakładka .NET dla Cef. Ułatwia to programistom korzystanie z języka C# lub innych języków .NET w celu zintegrowania szybkiej przeglądarki internetowej z ich aplikacjami .NET na komputery stacjonarne.
• Przeglądanie stron internetowych w aplikacjach desktopowych: Dzięki CefSharp programiści mogą z łatwością włączać funkcje przeglądania stron internetowych do swoich programów desktopowych. Ta funkcja otwiera przed programistami szerokie możliwości, umożliwiając im włączanie materiałów internetowych do interfejsów użytkownika lub tworzenie unikalnych aplikacji desktopowych z obsługą sieci. Może otrzymywać wywołania zwrotne po uruchomieniu zdarzeń JavaScript.
• Obsługa zaawansowanych technologii internetowych: Korzystając z CefSharp, programiści mogą wykorzystać wszystkie możliwości oferowane przez Chromium, w tym obsługę najnowszych standardów internetowych, takich jak HTML5, CSS3, JavaScript, WebGL i innych nowoczesnych standardów internetowych. Umożliwia to włączenie najnowocześniejszych technologii internetowych do programów desktopowych.
• Elastyczność i dostosowywanie: CefSharp zapewnia programistom dużą elastyczność i możliwości dostosowywania, pozwalając im obsługiwać zdarzenia, wykonywać kod JavaScript, wchodzić w interakcję z treściami online oraz modyfikować zachowanie przeglądarki w celu dostosowania jej do konkretnych potrzeb aplikacji. CefSharp z WebGL, który wykorzystuje OpenGL/DirectX do renderowania z przyspieszeniem sprzętowym, obsługuje treści 3D.

Dzięki wykorzystaniu CefSharp programiści mogą ulepszyć aplikacje desktopowe, ułatwiając przeglądanie stron internetowych, zachęcając użytkowników do interakcji oraz zapewniając im bogate, aktualne informacje w środowisku aplikacji.

Przykładowy kod:

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

Ten kod wykorzystuje CefSharp do tworzenia podstawowej aplikacji WinForms z wbudowaną przeglądarką internetową opartą na Chromium. Oto wyjaśnienie:

• Zainicjuj ustawienia CefSharp, używając CefSettings.
• ChromiumWebBrowser: Ta klasa reprezentuje kontrolkę przeglądarki internetowej dostarczaną przez CefSharp.
• Zdarzenie LoadingStateChanged obsługuje zmiany stanu ładowania przeglądarki, na przykład, gdy strona się ładuje.
• Zdarzenie MainForm_FormClosing zapewnia, że zasoby Cef są prawidłowo zamykane po zamknięciu formularza.

Aby zapoznać się z podstawowym przykładem aplikacji zbudowanych przy użyciu CefSharp, gotowych do kompilacji, zobacz Minimal Example Project na GitHubie. Bardziej skomplikowane projekty przykładów są dostępne w kodzie źródłowym projektu.

Zainstaluj IronPDF

Aby zdobyć bibliotekę IronPDF, musisz wykonać następujące kroki. Wpisz następujący kod w Menedżerze Pakietów:

:ProductInstall 

:ProductInstall 

Alternatywnie, można użyć Menedżera Pakietów NuGet, aby wyszukać pakiet "IronPDF". Z listy wszystkich pakietów NuGet związanych z IronPDF wybierz i pobierz niezbędny pakiet.

Using IronPDF in CefSharp C

Aby zintegrować IronPDF z CefSharp w aplikacji C#, musisz wykonać dwa kroki: wykorzystać przeglądarkę opartą na Chromium udostępnianą przez CefSharp do renderowania zawartości HTML, a następnie użyć IronPDF do konwersji tych informacji HTML na dokument PDF. Poniższy przykład demonstruje, jak osiągnąć tę integrację:

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

Ten kod pokazuje prostą integrację, w której zawartość HTML ładowana w przeglądarce Chromium jest przechwytywana, a następnie IronPDF jest używany do przekształcenia jej w dokument PDF. Oto wyjaśnienie:

• Zainicjuj CefSharp, aby zintegrować przeglądarkę Chromium z aplikacją Windows Forms.
• ChromiumWebBrowser Kontrola: Ta kontrola ładuje określony URL (w tym przykładzie, "https://ironpdf.com/") do przeglądarki i tworzy jego instancję.
• LoadingStateChanged Zdarzenie: Śledzi postęp ładowania przeglądarki. Gdy strona kończy ładowanie (e.IsLoading jest false), ChromeBrowser asynchronicznie przechwytuje zawartość HTML załadowanej strony, używając GetSourceAsync().
• Integracja z IronPDF: Przechwycona zawartość HTML (htmlContent) jest konwertowana do dokumentu PDF przy użyciu funkcji HtmlToPdf IronPDF. Wygenerowany PDF jest zapisywany jako "Output.pdf".
• Zamykanie formularza: Upewnij się, że zasoby Cef są prawidłowo zamykane, wywołując Cef.Shutdown() po zamknięciu formularza.

Ten kod pokazuje prostą integrację, w której zawartość HTML ładowana w przeglądarce Chromium jest przechwytywana, a następnie konwertowana na dokument PDF przy użyciu IronPDF. Dostosuj URL, obsługę błędów i inne aspekty zgodnie ze specyficznymi potrzebami twojej aplikacji. Więcej informacji o dokumentacji IronPDF można znaleźć w Pakiecie NuGet IronPDF.