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:

• Initialize the CefSharp settings using CefSettings.
• ChromiumWebBrowser: Ta klasa reprezentuje kontrolkę przeglądarki internetowej dostarczaną przez CefSharp.
• The LoadingStateChanged event handles the browser's loading state changes, for example, when a page finishes loading.
• The MainForm_FormClosing event ensures that Cef resources are properly shut down upon form closure.

Aby zapoznać się z podstawowym przykładem aplikacji zbudowanych przy użyciu CefSharp, gotowych do kompilacji, zobacz Minimal Example Project na GitHubie. More complicated example projects are available in the project's source.

Zainstaluj IronPDF

Aby pozyskać bibliotekę IronPDF, wykonaj poniższe kroki. Wprowadź następujący kod w konsoli menedżera pakietów:

Install-Package IronPdf 
dotnet add package IronPdf

Install-Package IronPdf 
dotnet add package IronPdf

Alternatywnie możesz 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.

Używanie IronPDF w CefSharp C

Aby zintegrować IronPDF z CefSharp w aplikacji C#, należy wykonać dwa kroki: wykorzystać przeglądarkę opartą na Chromium dostarczoną przez CefSharp do renderowania treś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 demonstruje prostą integrację, w której treść HTML załadowana w przeglądarce Chromium jest przechwytywana, a IronPDF jest używany do przekształcenia jej w dokument PDF. Oto wyjaśnienie:

• Inicjalizacja CefSharp w celu integracji przeglądarki Chromium z aplikacją Windows Forms.
• Kontrolka ChromiumWebBrowser: ta kontrolka ładuje określony adres URL (w tym przykładzie "https://ironpdf.com/") do przeglądarki i tworzy jej instancję.
• Zdarzenie LoadingStateChanged: śledzi postęp ładowania przeglądarki. Gdy strona zakończy ładowanie (e.IsLoading jest false), ChromeBrowser asynchronicznie przechwytuje zawartość HTML załadowanej strony za pomocą GetSourceAsync().
• Integracja IronPDF: przechwycona zawartość HTML (htmlContent) jest konwertowana na dokument PDF przy użyciu możliwości HtmlToPdf biblioteki IronPDF. Wygenerowany plik PDF jest zapisywany jako "Output.pdf".
• Zamykanie formularza: upewnienie się, że zasoby Cef są prawidłowo zamykane poprzez wywołanie Cef.Shutdown() po zamknięciu formularza.

Ten kod demonstruje prostą integrację, w której treść HTML załadowana w przeglądarce Chromium jest przechwytywana i konwertowana na dokument PDF przy użyciu IronPDF. Dostosuj adres URL, obsługę błędów i inne aspekty zgodnie ze specyficznymi potrzebami Twojej aplikacji. Aby uzyskać więcej informacji na temat dokumentacji IronPDF, zapoznaj się z pakietem NuGet IronPDF.