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

Install-Package 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.");
            });
        }
    }
}

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

MyWindowsService.exe install

MyWindowsService.exe install

MyWindowsService.exe start

MyWindowsService.exe start

MyWindowsService.exe uninstall

MyWindowsService.exe uninstall

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

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.