Cefsharp.WPF.NET Core (Wie es für Entwickler funktioniert)

Bedeutung von CefSharp

CefSharp ist ein Framework, das die Art und Weise transformiert, wie Entwickler Desktop-Apps und Automatisierungsprojekte mit integrierten Websurfmöglichkeiten konstruieren, indem es die Leistung der Webbrowser-Engine von Chromium nahtlos in .NET-Anwendungen integriert. Mit der Hilfe von CefSharp können wir entfernte Webinhalte anzeigen, einschließlich eingebetteter UI, die mit HTML5-Unterstützung erstellt wurde.

Wichtige Punkte, die in einer CefSharp-Einführung hervorgehoben werden sollten, sind:

• Das Chromium Embedded Framework (CEF) dient als Basis für CefSharp, das die Integration der Funktionen des Chromium-Browsers in andere Programme ermöglicht. Durch die Nutzung von Googles Chromium-Projekt verbessert CefSharp Desktop-Programme mit ausgeklügelten Webfunktionen.
• .NET-Integration: CefSharp ist ein leistungsstarker .NET-Wrapper für Cef. Es erleichtert es Programmierern, einen schnellen Webbrowser in ihre .NET-Desktop-Anwendungen zu integrieren, indem sie C# oder andere .NET-Sprachen verwenden.
• Web-Surfen in Desktop-Apps: Mit CefSharp können Entwickler leicht Web-Surffunktionen in ihre Desktop-Programme integrieren. Dieses Feature eröffnet Entwicklern eine Welt von Möglichkeiten, indem es ihnen erlaubt, Online-Inhalte in ihre Benutzerschnittstellen zu integrieren oder einzigartige Desktop-Apps zu erstellen, die webbasiert sind. Es kann einen Rückruf erhalten, wenn JavaScript-Ereignisse ausgelöst werden.
• Unterstützung für reiche Webtechnologien: Durch die Verwendung von CefSharp können Entwickler alle Fähigkeiten nutzen, die Chromium bietet, einschließlich Unterstützung für die neuesten Webstandards wie HTML5, CSS3, JavaScript, WebGL und andere moderne Webstandards. Dies ermöglicht es, modernste Webtechnologien in Desktop-Programme zu integrieren.
• Flexibilität und Anpassung: CefSharp bietet Entwicklern eine große Flexibilität und Anpassungsmöglichkeiten, um Ereignisse zu handhaben, JavaScript auszuführen, mit Online-Inhalten zu interagieren und das Browserverhalten an besondere Anwendungsbedürfnisse anzupassen. CefSharp mit WebGL, das OpenGL/DirectX für hardwarebeschleunigtes Rendering nutzt, unterstützt 3D-Inhalte.

Durch die Nutzung von CefSharp können Entwickler Desktop-Anwendungen verbessern, indem sie Web-Surferlebnisse erleichtern, Benutzerinteraktionen fördern und den Nutzern innerhalb der Anwendungsumgebung reichhaltige, moderne Informationen bereitstellen.

Beispielcode:

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

Dieser Code verwendet CefSharp, um eine einfache WinForms-Anwendung mit einem eingebetteten Webbrowser basierend auf Chromium zu entwickeln. Hier ist eine Erklärung:

• Initialisieren Sie die CefSharp-Einstellungen mit CefSettings.
• ChromiumWebBrowser: Diese Klasse stellt die von CefSharp bereitgestellte Webbrowser-Steuerung dar.
• Das LoadingStateChanged Ereignis behandelt die Ladezustandsänderungen des Browsers, zum Beispiel, wenn eine Seite das Laden beendet.
• Das MainForm_FormClosing-Ereignis stellt sicher, dass die Cef-Ressourcen bei Schließen des Formulars ordnungsgemäß heruntergefahren werden.

Für ein einfaches Beispiel von Apps, die mit CefSharp gebaut und bereit zur Kompilierung sind, siehe das Minimale Beispielprojekt auf GitHub. Komplexere Beispielprojekte sind im Quellcode des Projekts verfügbar.

IronPDF installieren

Um die IronPDF-Bibliothek zu erwerben, müssen Sie die folgenden Schritte befolgen. Geben Sie den folgenden Code in den Paket-Manager ein:

Install-Package IronPdf 
dotnet add package IronPdf

Install-Package IronPdf 
dotnet add package IronPdf

Alternativ können Sie den NuGet-Paketmanager verwenden, um nach dem Paket "IronPDF" zu suchen. Wählen und laden Sie das notwendige Paket aus der Liste aller NuGet-Pakete, die mit IronPDF in Verbindung stehen, herunter.

Verwendung von IronPDF in CefSharp C#

Um IronPDF mit CefSharp in einer C#-Anwendung zu integrieren, müssen Sie zwei Schritte ausführen: den auf Chromium basierenden Browser von CefSharp nutzen, um HTML-Inhalte anzuzeigen, und dann IronPDF verwenden, um diese HTML-Informationen in ein PDF-Dokument zu konvertieren. Das folgende Beispiel zeigt, wie diese Integration durchgeführt werden kann:

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

Dieser Code veranschaulicht eine einfache Integration, bei der der im Chromium-Browser geladene HTML-Inhalt abgefangen wird und IronPDF verwendet wird, um ihn in ein PDF-Dokument umzuwandeln. Hier ist eine Erklärung:

• Initialisieren Sie CefSharp, um den Chromium-Browser in eine Windows Forms-Anwendung zu integrieren.
• ChromiumWebBrowser-Steuerelement: Dieses Steuerelement lädt eine bestimmte URL (in diesem Beispiel "https://ironpdf.com/") in den Browser und erstellt eine Instanz davon.
• LoadingStateChanged-Ereignis: Verfolgt den Ladefortschritt des Browsers. Wenn das Laden der Seite abgeschlossen ist (e.IsLoading ist falsch), erfasst der Chrome-Browser asynchron den HTML-Inhalt der geladenen Seite mit GetSourceAsync().
• IronPDF-Integration: Der erfasste HTML-Inhalt (htmlContent) wird unter Verwendung der HtmlToPdf-Funktionalität von IronPDF in ein PDF-Dokument konvertiert. Das erzeugte PDF wird als "Output.pdf" gespeichert.
• Formularschließen: Stellen Sie sicher, dass Cef-Ressourcen ordnungsgemäß heruntergefahren werden, indem Sie Cef.Shutdown() nach dem Schließen des Formulars aufrufen.

Dieser Code veranschaulicht eine einfache Integration, bei der der im Chromium-Browser geladene HTML-Inhalt abgefangen und dann durch IronPDF in ein PDF-Dokument umgewandelt wird. Passen Sie die URL, Fehlerbehandlung und andere Aspekte entsprechend den spezifischen Anforderungen Ihrer Anwendung an. Für weitere Informationen zur IronPDF-Dokumentation, besuchen Sie bitte das IronPDF NuGet Package.