Cefsharp.WPF.NET Core (Geliştiriciler İçin Nasıl Çalışır)

CefSharp'ın Önemi

CefSharp, Chromium'un web tarayıcı motorunu .NET uygulamalarına kolayca entegre ederek geliştiricilerin masaüstü uygulamaları ve otomasyon projeleri oluşturmalarını sağlayan bir çerçevedir. CefSharp yardımıyla, HTML5 desteği ile oluşturulmuş yerleşik UI dahil uzak web içeriğini gösterebiliriz.

CefSharp tanıtımında vurgulanması gereken önemli noktalar:

• Chromium Embedded Framework (CEF), CefSharp için bir çerçeve görevi görerek Chromium tarayıcının özelliklerinin diğer programlara entegrasyonunu sağlar. CefSharp, Google'ın Chromium projesini kullanarak masaüstü programları gelişmiş web özellikleri ile zenginleştirir.
• .NET Entegrasyonu: CefSharp, Cef için güçlü bir .NET sarmalayıcısıdır. Programcılara hızlı bir web tarayıcısını masaüstü .NET uygulamalarına entegre etmek için C# veya diğer .NET dillerini kullanmayı kolaylaştırır.
• Masaüstü Uygulamalarında Web Gezintisi: CefSharp ile geliştiriciler, masaüstü programlarına kolayca web tarama özelliklerini ekleyebilirler. Bu özellik, geliştiricilere kullanıcı ara yüzlerine çevrimiçi içerik eklemeye veya web özellikli benzersiz masaüstü uygulamaları oluşturmaya olanak tanıyarak bir olanaklar dünyası açar. JavaScript olayları tetiklendiğinde bir geri arama alabilir.
• Zengin Web Teknolojileri Desteği: CefSharp kullanarak geliştiriciler, HTML5, CSS3, JavaScript, WebGL ve diğer modern web standartları gibi yeni web standartları desteği de dahil olmak üzere Chromium'un sunduğu tüm yeteneklerden yararlanabilir. Bu, masaüstü programlarına son teknoloji web teknolojilerinin dahil edilmesini mümkün kılar.
• Esneklik ve Özelleştirme: CefSharp, geliştiricilere olayları yönetme, JavaScript'i yürütme, çevrimiçi içerik ile etkileşimde bulunma ve tarayıcı davranışını belirli uygulama ihtiyaçlarına uyacak şekilde özelleştirme olanağı sunarak büyük esneklik ve özelleştirme olanakları sağlar. CefSharp, donanım hızlandırmalı render için OpenGL/DirectX'i kullanan WebGL ile 3D içeriği destekler.

CefSharp kullanarak geliştiriciler, masaüstü uygulamaları geliştirerek web gezintisi deneyimlerini kolaylaştırabilir, kullanıcı etkileşimini teşvik edebilir ve kullanıcıları uygulama ortamında zengin, çağdaş bilgiyle sağlayabilir.

Örnek 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

Bu kod, Chromium tabanlı yerleşik bir web tarayıcısı ile basit bir WinForms uygulaması geliştirmek için CefSharp kullanır. Açıklaması burada:

• CefSharp ayarlarını CefSettings kullanarak başlatın.
• ChromiumWebBrowser: Bu sınıf, CefSharp tarafından sağlanan web tarayıcı kontrolünü temsil eder.
• LoadingStateChanged olayı, örneğin, bir sayfa yüklemeyi bitirdiğinde tarayıcının yükleme durumu değişimlerini yönetir.
• MainForm_FormClosing olayı, Cef kaynaklarının form kapandığında düzgün bir şekilde kapatılmasını sağlar.

Derlemeye hazır, CefSharp kullanılarak oluşturulan temel örnek uygulamalar için GitHub'daki Minimal Example Project başvurun. Projenin kaynağında daha karmaşık örnek projeler mevcuttur.

IronPDF Yükleyin

IronPDF kütüphanesini edinmek için önümüzdeki adımları takip etmeniz gerekir. Paket Yöneticisi'ne aşağıdaki kodu girin:

Install-Package IronPdf 
dotnet add package IronPdf

Install-Package IronPdf 
dotnet add package IronPdf

Alternatif olarak, "IronPDF" paketini aramak için NuGet Paket Yöneticisi kullanabilirsiniz. IronPDF ile ilgili tüm NuGet paketleri listesinden gerekli paketi seçip indirin.

Using IronPDF in CefSharp C

C# uygulamasında CefSharp ile IronPDF'yi entegre etmek için iki adım atmanız gerekir: HTML içeriğini işlemek için CefSharp tarafından sağlanan Chromium tabanlı tarayıcıyı kullanın ve ardından bu HTML bilgisini PDF belgesine dönüştürmek için IronPDF'yi kullanın. Bu entegrasyonu nasıl gerçekleştireceğinizi gösteren örnek:

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

Bu kod, Chromium tarayıcıda yüklenen HTML içeriğinin kesildiği ve IronPDF kullanılarak bir PDF belgesine dönüştürüldüğü basit bir entegrasyonu göstermektedir. Açıklaması burada:

• Chromium tarayıcıyı Windows Forms uygulamasına entegre etmek için CefSharp başlatın.
• ChromiumWebBrowser Kontrol: Bu kontrol, belirli bir URL'yi (bu örnekte, "https://ironpdf.com/") tarayıcıya yükler ve onun bir örneğini oluşturur.
• LoadingStateChanged Olayı: Tarayıcının yükleme ilerlemesini izler. Sayfa yüklemeyi bitirdiğinde (e.IsLoading yanlışsa), ChromeBrowser, yüklenen sayfanın HTML içeriğini GetSourceAsync() kullanarak eş zamanlı olarak yakalar.
• IronPDF Entegrasyonu: Yakalanan HTML icerigi (htmlContent) IronPDF'in HtmlToPdf ozelligi kullanilarak bir PDF belgesine dönüştürulur. Elde edilen PDF "Output.pdf" olarak kaydedilir.
• Form Kapatma: Form kapatıldıktan sonra Cef.Shutdown() çağrılarak Cef kaynaklarının düzgün bir şekilde kapatıldığından emin olun.

Bu kod, Chromium tarayıcıda yüklenen HTML içeriğinin kesildiği ve ardından IronPDF kullanılarak bir PDF belgesine dönüştürüldüğü basit bir entegrasyonu göstermektedir. URL'yi, hata yapısını ve diğer hususları uygulamanızın özel ihtiyaçlarına göre özelleştirin. IronPDF dokümantasyonu hakkında daha fazla bilgi için lütfen IronPDF NuGet Paketine başvurun.