Topshelf adlı açık kaynaklı bir paket, .NET'te Windows servisleri oluşturmayı kolaylaştırmak için geliştirilmiştir. Sunduğu çerçeve, Windows servisleri oluşturma, dağıtma ve yönetme işlemlerini kolaylaştırır ve geliştiricilerin iş mantığına odaklanmasını sağlar, servis kontrol yönetiminin karmaşıklıklarına değil. IronPDF ile birlikte kullanıldığında, PDF dosyaları oluşturma ve değiştirme konusunda zengin özelliklere sahip bir C# kütüphanesi ile geliştiriciler, karmaşık belge işleme görevlerini yönetebilen güvenilir ve güçlü servisler oluşturabilir.

Bu bağlantı, tam bir Windows servis çerçevesi içinde PDF oluşturma, revizyon ve dağıtım işlemlerini otomatikleştirerek etkili ve otomatikleştirilmiş doküman iş akışlarına ihtiyaç duyan kuruluşlar için sorunsuz bir çözüm sunar. C# içinde IronPDF .NET için'i Topshelf ile birlikte kullanarak geliştiriciler, servis uygulamalarında yüksek işlevsellik ve sürdürülebilirlik elde edebilir, hem sağlamlığı hem de kullanımı kolaylığı garanti eder.

Topshelf C# nedir?

Topshelf .NET paketi, Windows servislerinin geliştirilmesini, kurulumunu ve uygulanmasını kolaylaştıran açık kaynaklı bir projedir. Windows servisleri oluşturma sürecindeki bir çok karmaşıklığı ortadan kaldırarak, geliştiricilerin uygulamalarının temel özelliklerine daha fazla odaklanmasını sağlar, Windows servis yönetimi detaylarına değil.

Topshelf geliştiricilerin küçük kod değişiklikleri ile konsol uygulamalarını servis haline getirmesini kolaylaştırır. Ayrıca, servis ayarlarını kurmak için bağımlılıkları, kurtarma seçeneklerini ve servisleri başlatma ve durdurma eylemlerini kurmak için akıcı bir API sunar. .NET geliştiricileri için, stabil ve yönetilebilir Windows servislerini etkili bir şekilde oluşturmak isteyen için, Topshelf kullanımı kolaylığı ve uyarlanabilirliği nedeniyle popüler bir seçenektir.

Topshelf tarafından sunulan bir dizi özellik, .NET'te Windows servisleri tasarlamayı ve yönetmeyi kolaylaştırır. İşte bazı önemli özellikleri:

Kullanım Kolaylığı

Topshelf, Windows servislerinin yapılandırılmasını ve yönetilmesini basitleştiren basit ve akıcı bir API sağlar. Konsol uygulamaları geliştiriciler tarafından az veya hiç kod değişikliği ile kolayca servis haline getirilebilir.

Yapılandırma Esnekliği

Başlatma, durdurma, duraklatma ve devam ettirme eylemleri arasında yapılandırma seçenekleri vardır. Geliştiriciler, servis sınıfları için servis bağımlılıkları ve kurtarma seçeneklerini de belirleyebilir.

Kurulum ve Kaldırma

.NET Framework kullanılarak yazılan barındırma servislerinin dağıtımı, Topshelf'in yerleşik servis kurma ve kaldırma işlevleri tarafından kolaylaştırılır. Programatik olarak veya komut satırı aracılığıyla servisler kurulabilir.

Günlük Kaydı

Topshelf, log4net, NLog ve Serilog gibi tanınmış günlükleme çerçeveleri ile entegre olarak, geliştiricilerin servis işlemleri ve hataları verimli bir şekilde kaydetme yeteneğini kolaylaştırır.

Servis Kontrolü

Duraklatma, devam ettirme, başlatma ve durdurma gibi tüm yaygın Windows servis kontrolleriyle uyumludur. Geliştiriciler artık tüm servis yaşam döngüsü üzerinde tam kontrole sahiptir.

Hata Yönetimi

Topshelf, hataların düzgün bir şekilde işlenmesini ve servislerin stabil kalmasını garanti eden güçlü bir hata yönetimi özelliğine sahiptir.

Birden Fazla Servis Örneği

Aynı uygulama içinde birden fazla servis örneği oluşturulmasına ve yönetilmesine olanak tanıyarak karmaşık servis mimarileri için esneklik sağlar.

Özel Komut Satırı Seçenekleri

Özel komut satırı seçenekleri, geliştiricilerin servislerinin davranışını daha özelleştirmelerine ve kontrol etmelerine olanak tanır.

Çevre Farkındalığı

Topshelf, üretim sunucusu, test ortamı veya geliştirme sistemi olup olmadığına göre ortamını tanıyabilir ve buna uyum sağlayabilir.

Bağımlılık Enjeksiyonu Desteği

Bağımlılık enjeksiyonu çerçeveleri ile birlikte kullanıldığında, Topshelf daha iyi yazılım mimarisini kolaylaştırır ve servis bağımlılıklarının yönetilmesini kolaylaştırır.

Çapraz Platform Yetenekleri

Topshelf esas olarak Windows için oluşturulmuş olsa da, diğer işletim sistemleriyle uyumluğunu artırarak .NET Core kullanıldığında Linux ve macOS'ta da servis çalıştırabilir.

Create and Config Topshelf C#

C# içinde Topshelf kullanarak bir Windows servisi oluşturmak ve yapılandırmak için şu adımları izleyin:

Yeni Bir Visual Studio Projesi Oluşturun

Visual Studio ile bir konsol projesi oluşturmak kolaydır. Visual Studio ortamında bir Konsol Uygulaması başlatmak için bu basit adımları izleyin:

Visual Studio'yu kullanmadan önce, bilgisayarınıza yüklediğinizden emin olun.

Yeni Bir Proje Başlatın

Dosya, Proje seçeneğini seçtikten sonra Yeni menüsünü seçin.

Aşağıdaki proje şablon referans listesinden "Console App" veya "Console App (.NET Core)" seçeneğini seçin.

Projenize bir ad vermek için, lütfen "Ad" alanını doldurun.

Projenin depolama konumunu seçin.

Konsol uygulama projesi "Oluştur" tıkladığınızda açılacaktır.

NuGet üzerinden Topshelf Yükle

NuGet Paket Yöneticisi'ni kullanarak projenize öncelikle Topshelf ekleyin. Paket Yöneticisi ve Konsol uygulamasında aşağıdaki komutu çalıştırın:

Install-Package Topshelf

Servis Sınıfı Oluştur

Sınıfın servis mantığını tanımlayın. Başlat ve Durdur gibi hizmet eylemlerinin bu sınıfta uygulanması gereklidir.

using System;
using Topshelf;

namespace MyWindowsService
{
    // Define a simple service class with Start and Stop methods
    public class MyService
    {
        public bool Start()
        {
            // Service start logic
            Console.WriteLine("Service Started.");
            return true;
        }

        public bool Stop()
        {
            // Service stop logic
            Console.WriteLine("Service Stopped.");
            return true;
        }
    }

    // Main program class to run the Topshelf service
    class Program
    {
        static void Main(string[] args)
        {
            HostFactory.Run(x =>
            {
                // Configure the service
                x.Service<MyService>(s =>
                {
                    s.ConstructUsing(name => new MyService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });

                // Run the service as a local system
                x.RunAsLocalSystem();

                // Set service details
                x.SetServiceName("MyService");
                x.SetDisplayName("My Service");
                x.SetDescription("This is a sample service created using Topshelf.");
            });
        }
    }
}

using System;
using Topshelf;

namespace MyWindowsService
{
    // Define a simple service class with Start and Stop methods
    public class MyService
    {
        public bool Start()
        {
            // Service start logic
            Console.WriteLine("Service Started.");
            return true;
        }

        public bool Stop()
        {
            // Service stop logic
            Console.WriteLine("Service Stopped.");
            return true;
        }
    }

    // Main program class to run the Topshelf service
    class Program
    {
        static void Main(string[] args)
        {
            HostFactory.Run(x =>
            {
                // Configure the service
                x.Service<MyService>(s =>
                {
                    s.ConstructUsing(name => new MyService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });

                // Run the service as a local system
                x.RunAsLocalSystem();

                // Set service details
                x.SetServiceName("MyService");
                x.SetDisplayName("My Service");
                x.SetDescription("This is a sample service created using Topshelf.");
            });
        }
    }
}

Imports System
Imports Topshelf

Namespace MyWindowsService
	' Define a simple service class with Start and Stop methods
	Public Class MyService
		Public Function Start() As Boolean
			' Service start logic
			Console.WriteLine("Service Started.")
			Return True
		End Function

		Public Function [Stop]() As Boolean
			' Service stop logic
			Console.WriteLine("Service Stopped.")
			Return True
		End Function
	End Class

	' Main program class to run the Topshelf service
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			HostFactory.Run(Sub(x)
				' Configure the service
				x.Service(Of MyService)(Sub(s)
					s.ConstructUsing(Function(name) New MyService())
					s.WhenStarted(Function(tc) tc.Start())
					s.WhenStopped(Function(tc) tc.Stop())
				End Sub)

				' Run the service as a local system
				x.RunAsLocalSystem()

				' Set service details
				x.SetServiceName("MyService")
				x.SetDisplayName("My Service")
				x.SetDescription("This is a sample service created using Topshelf.")
			End Sub)
		End Sub
	End Class
End Namespace

Imports System
Imports Topshelf

Namespace MyWindowsService
	' Define a simple service class with Start and Stop methods
	Public Class MyService
		Public Function Start() As Boolean
			' Service start logic
			Console.WriteLine("Service Started.")
			Return True
		End Function

		Public Function [Stop]() As Boolean
			' Service stop logic
			Console.WriteLine("Service Stopped.")
			Return True
		End Function
	End Class

	' Main program class to run the Topshelf service
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			HostFactory.Run(Sub(x)
				' Configure the service
				x.Service(Of MyService)(Sub(s)
					s.ConstructUsing(Function(name) New MyService())
					s.WhenStarted(Function(tc) tc.Start())
					s.WhenStopped(Function(tc) tc.Stop())
				End Sub)

				' Run the service as a local system
				x.RunAsLocalSystem()

				' Set service details
				x.SetServiceName("MyService")
				x.SetDisplayName("My Service")
				x.SetDescription("This is a sample service created using Topshelf.")
			End Sub)
		End Sub
	End Class
End Namespace

Hizmeti Yapılandır

Hizmeti başlatma ve sonlandırma mekanizması MyService sınıfında içerir. Hizmet tanımı ve yaşam döngüsü yöntemleri (Başlat ve Durdur), Topshelf ayarlarını barındıran Program sınıfındaki ilgili hizmet eylemleriyle bağlantılıdır. Bir hizmet sınıfının run yöntemi kullanılarak ad, görüntü adı ve açıklama gibi hizmetin özellikleri ayarlanır. Topshelf kullanarak Windows hizmetlerini yönetmek ve dağıtmak bu kısa yapılandırma ile basitleşir.

Hizmeti Oluştur ve Kur

Projenizi oluştururken hatasız olduğundan emin olun. Komut satırından hizmeti başlatmak için derlenmiş çalıştırılabilir dosyayla birlikte kurma komutunu kullanın:

MyWindowsService.exe install

MyWindowsService.exe install

Hizmeti Başlat

Hizmet kurulduktan sonra hizmeti başlatmak için aşağıdaki komutu kullanın:

MyWindowsService.exe start

MyWindowsService.exe start

Hizmeti Kaldır

Gerekirse hizmeti kaldırmanız için aşağıdaki komut satırını kullanın:

MyWindowsService.exe uninstall

MyWindowsService.exe uninstall

Bu örnek, Topshelf C#'ta nasıl bir Windows hizmeti oluşturulup yapılandırılacağını gösterir. Topshelf, Windows hizmetlerinin tanımlanması, kurulumu, ayarlanması ve yönetilmesi işlemlerini basitleştirir ve az veya hiç kod gereksinimi kalmaz.

Başlarken

C# içinde IronPDF ve Topshelf kullanarak bir Windows servisi oluşturmaya başlamak için aşağıdaki adımları izleyin:

IronPDF Nedir?

IronPDF .NET için Libraries, PDF belgeleri oluşturma, okuma ve düzenleme amacıyla kullanılabilecek zengin özelliklere sahip bir .NET kütüphanesidir. Bu programla, geliştiriciler HTML, CSS ve JavaScript içeriğinden baskıya hazır, yüksek kaliteli PDF'ler kolayca üretebilir. PDF'leri bölme ve birleştirme, belgelere filigran ekleme, başlık ve alt bilgi ekleme ve HTML'yi PDF'ye dönüştürme gibi temel fonksiyonlar arasında sayılabilir. IronPDF hem .NET Framework hem de .NET Core'u destekleyerek geniş bir uygulama yelpazesi için faydalı hale gelmektedir.

PDF'ler entegrasyonu basit olduğu ve geniş dokümantasyona sahip olduğundan, geliştiriciler programlarına kolaylıkla entegre edebilir. IronPDF, karmaşık düzenleri ve formatlamaları kolaylıkla ele alarak oluşturulan PDF'lerin kaynak HTML içeriğine yakın olmasını sağlar.

IronPDF Özellikleri

HTML'den PDF Üretimi

JavaScript, HTML, ve CSS'i PDF'e dönüştür. Medya sorguları ve duyarlı tasarım gibi modern web standartlarını destekler. HTML ve CSS ile PDF faturaları, raporları ve belgeleri dinamik olarak süslemek için yararlıdır.

PDF Düzenleme

Önceden varolan PDF'lere metin, resimler ve diğer içerik eklenebilir. PDF dosyalarından metin ve görüntüleri çıkarın. Birçok PDF'i tek bir dosyada birleştirin. PDF dosyalarını birden çok ayrı belgeye ayırın. Filigranlar, açıklamalar, başlıklar ve altbilgiler ekleyin.

PDF Dönüşümü

Word, Excel ve resim dosyaları gibi çeşitli dosya formatlarını PDF formatına dönüştürün. PDF'den resme dönüştürme (PNG, JPEG, vb.).

Performans ve Güvenilirlik

Sanayi ortamlarında aranan yüksek performans ve güvenilirlik tasarım özellikleridir. Büyük belge setlerini kolaylıkla yönetir.

IronPDF Kurulumu

PDF'lerle .NET projelerinde çalışmak için gerekli araçları elde etmek için IronPDF paketini yükleyin.

Install-Package IronPdf

IronPDF ile Servis Sınıfınızı Oluşturun

IronPDF'in PDF dosyaları oluşturma ve düzenleme için işlevlerini ve sınıfın servis mantığını tanımlayın.

using System;
using IronPdf;
using Topshelf;

namespace PdfService
{
    // Define a service class with PDF generation logic
    public class MyPdfService
    {
        public bool Start()
        {
            Console.WriteLine("Service Starting...");
            GeneratePdf();
            return true;
        }

        public bool Stop()
        {
            Console.WriteLine("Service Stopping...");
            return true;
        }

        // Method to generate a PDF using IronPDF
        private void GeneratePdf()
        {
            var renderer = new HtmlToPdf();
            var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, PDF!</h1>");
            pdf.SaveAs("GeneratedDocument.pdf");
            Console.WriteLine("PDF Generated.");
        }
    }

    // Main program to configure and run the service using Topshelf
    class Program
    {
        static void Main(string[] args)
        {
            HostFactory.Run(x =>
            {
                x.Service<MyPdfService>(s =>
                {
                    s.ConstructUsing(name => new MyPdfService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });

                x.RunAsLocalSystem();
                x.SetServiceName("MyPdfService");
                x.SetDisplayName("My PDF Service");
                x.SetDescription("A service that generates PDF files using IronPDF and Topshelf.");
            });
        }
    }
}

using System;
using IronPdf;
using Topshelf;

namespace PdfService
{
    // Define a service class with PDF generation logic
    public class MyPdfService
    {
        public bool Start()
        {
            Console.WriteLine("Service Starting...");
            GeneratePdf();
            return true;
        }

        public bool Stop()
        {
            Console.WriteLine("Service Stopping...");
            return true;
        }

        // Method to generate a PDF using IronPDF
        private void GeneratePdf()
        {
            var renderer = new HtmlToPdf();
            var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, PDF!</h1>");
            pdf.SaveAs("GeneratedDocument.pdf");
            Console.WriteLine("PDF Generated.");
        }
    }

    // Main program to configure and run the service using Topshelf
    class Program
    {
        static void Main(string[] args)
        {
            HostFactory.Run(x =>
            {
                x.Service<MyPdfService>(s =>
                {
                    s.ConstructUsing(name => new MyPdfService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });

                x.RunAsLocalSystem();
                x.SetServiceName("MyPdfService");
                x.SetDisplayName("My PDF Service");
                x.SetDescription("A service that generates PDF files using IronPDF and Topshelf.");
            });
        }
    }
}

Imports System
Imports IronPdf
Imports Topshelf

Namespace PdfService
	' Define a service class with PDF generation logic
	Public Class MyPdfService
		Public Function Start() As Boolean
			Console.WriteLine("Service Starting...")
			GeneratePdf()
			Return True
		End Function

		Public Function [Stop]() As Boolean
			Console.WriteLine("Service Stopping...")
			Return True
		End Function

		' Method to generate a PDF using IronPDF
		Private Sub GeneratePdf()
			Dim renderer = New HtmlToPdf()
			Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello, PDF!</h1>")
			pdf.SaveAs("GeneratedDocument.pdf")
			Console.WriteLine("PDF Generated.")
		End Sub
	End Class

	' Main program to configure and run the service using Topshelf
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			HostFactory.Run(Sub(x)
				x.Service(Of MyPdfService)(Sub(s)
					s.ConstructUsing(Function(name) New MyPdfService())
					s.WhenStarted(Function(tc) tc.Start())
					s.WhenStopped(Function(tc) tc.Stop())
				End Sub)

				x.RunAsLocalSystem()
				x.SetServiceName("MyPdfService")
				x.SetDisplayName("My PDF Service")
				x.SetDescription("A service that generates PDF files using IronPDF and Topshelf.")
			End Sub)
		End Sub
	End Class
End Namespace

Imports System
Imports IronPdf
Imports Topshelf

Namespace PdfService
	' Define a service class with PDF generation logic
	Public Class MyPdfService
		Public Function Start() As Boolean
			Console.WriteLine("Service Starting...")
			GeneratePdf()
			Return True
		End Function

		Public Function [Stop]() As Boolean
			Console.WriteLine("Service Stopping...")
			Return True
		End Function

		' Method to generate a PDF using IronPDF
		Private Sub GeneratePdf()
			Dim renderer = New HtmlToPdf()
			Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello, PDF!</h1>")
			pdf.SaveAs("GeneratedDocument.pdf")
			Console.WriteLine("PDF Generated.")
		End Sub
	End Class

	' Main program to configure and run the service using Topshelf
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			HostFactory.Run(Sub(x)
				x.Service(Of MyPdfService)(Sub(s)
					s.ConstructUsing(Function(name) New MyPdfService())
					s.WhenStarted(Function(tc) tc.Start())
					s.WhenStopped(Function(tc) tc.Stop())
				End Sub)

				x.RunAsLocalSystem()
				x.SetServiceName("MyPdfService")
				x.SetDisplayName("My PDF Service")
				x.SetDescription("A service that generates PDF files using IronPDF and Topshelf.")
			End Sub)
		End Sub
	End Class
End Namespace

Topshelf ile birlikte kullanarak, geliştiriciler C# içerisinde PDF üretimi ve işlemi için güçlü Windows servislerini hızlıca tasarlayabilir. Topshelf, Windows servislerini kurmak ve yönetmek için akıcı ve kullanıcı dostu bir API sunar.

Hizmeti başlatma (Start) ve sonlandırma (Stop) işlemlerini implemente eden MyPdfService sınıfı, verilen örnekte hizmet mantığını kapsar. HTML metninden basit bir PDF belgesi oluşturmak için Start metodunda IronPDF kullanılır. The ability to render HTML into a PDF format using IronPDF's HtmlToPdf class is demonstrated, showing how to turn basic HTML information (such as "

Hello, PDF!

Bu entegrasyon, Topshelf'in hizmetin yaşam süresini yöneterek tama bir Windows hizmeti olarak çalışmasını sağlarken, IronPDF'in, PDF oluşturma sürecini kolaylıkla yönettiğini göstermektedir. Topshelf ve IronPDF'in C# içindeki birleşik yetenekleri ile bu entegrasyon, otomatik belge oluşturma veya değiştirme ihtiyacı duyan uygulamalar için mükemmeldir. Güvenilirlik ve bakım kolaylığı sunar.

Sonuç

Sonuç olarak, Topshelf ve IronPDF'in C# içerisindeki birleşimi, PDF'lerin oluşturulması ve yönetimi ile ilgili Windows hizmetlerini oluşturmayı ve yönetmeyi mümkün kılar. Topshelf, Windows servislerinin dağıtımını basitleştirerek, hizmet yapılandırması ve yönetimi için kullanıcı dostu bir API sağlar. IronPDF, hizmet mantığı içinde HTML bilgilerinden PDF belgelerinin sorunsuz üretilmesini kolaylaştırarak işlevselliği geliştirir.

Bu entegrasyon, otomatik belge iş akışlarında güvenilir ve güçlü performansı garanti ederken, geliştirme sürecini de kolaylaştırmaktadır. C# içindeki Topshelf ile IronPDF, geliştiricilerin rapor, fatura veya diğer PDF tabanlı görevleri için karmaşık belge işleme çözümleri oluşturmasına olanak tanıyan esnek ve etkili bir seçenektir.

IronPDF ve Iron Software Lisans Bilgileri, geliştiricilere daha fazla çevrimiçi uygulama ve özellik sunmak ve daha etkili geliştirme sağlamak için Iron Software'den son derece esnek sistemleri ve paketi çekirdek desteği ile birleştirir.

Lisans seçenekleri net ve projeye özgü olduğunda, geliştiriciler hangi modelin en optimal olduğunu daha kolay belirleyebilir. Bu avantajlar, geliştiricilerin sorunları net, etkili ve bütünleşmiş bir şekilde çözmelerini sağlar.