跳至頁尾內容
.NET 幫助

Quartz .NET(開發者使用指引)

Quartz.NET 簡介

對於 .NET 應用程式,Quartz.NET 是廣受歡迎的開放原始碼任務排程工具組。 它為程式設計師打下了堅實的基礎,讓他們可以在預定的期間、間隔,或回應觸發條件時,規劃並執行工作、排程或流程。 Quartz.NET 使 .NET 應用程式更容易建構複雜的排程情境,無論是傳送通知、排程工作、產生報表或完成定期維護活動。 Quartz.NET 是完美的工作排程系統,適用於建立從小型應用程式到大型企業系統。

Quartz.NET 的最新排程版本可與各種支援的資料庫供應商進行無縫整合,讓開發人員能夠使用方便的擴充方法來擴充其功能,同時確保作為託管服務的任務執行的可靠性。

透過將 Quartz.NET 與 IronPDF for .NET 整合,可在 .NET 應用程式中建立具有強大 PDF 製作能力的可靠排程系統。 雖然 IronPDF 提供了一整套工具來建立、修改和顯示 PDF 文件,Quartz.NET 則提供了多功能且可靠的排程系統。 當這些工具結合起來時,就能讓開發人員自動化 PDF 製作作業,作為工作流程的一部分或排程背景工作,從而提高應用程式的實用性和功能性。

主要功能

彈性排程

Quartz.NET 可讓程式設計師建立排程,告訴程式在預定的間隔或時間執行(例如每小時、每天、每 30 分鐘)。 它與複雜的排程模式相容,例如 cron 表達式,可精確控制代碼、工作和服務的執行時間。

基於觸發的執行

在 Quartz.NET 中,工作可以由多種觸發器啟動。 這些工具包括基於日曆的觸發器(例如,不包括週末)、簡單觸發器(根據設定的時間表運作)、工作觸發器,以及依賴於外部情況或事件的定制觸發器。

工作持久性

Quartz.NET 具備以持續方式排程工作的能力,可將計劃中的工作及其完成記錄儲存於資料庫中。 保證工作排程在應用程式故障或重新啟動時的彈性,並使工作集群的高可用性和可擴展性成為可能。

貨幣控制

為了保證任務安全有效地完成,Quartz.NET 內建了並發控制工具。 為了控制作業執行的並發性,開發人員可以設定線程池、作業優先順序和執行限制。

工作鏈和依賴管理

由於 Quartz.NET 支援工作鏈和依賴性管理,因此工作可以按照指定的順序執行,而工作之間的關係也可以由開發人員定義。 這使得為背景工作、服務和程序建立複雜的協調情況成為可能。

錯誤處理與重試技巧

為了優雅地管理失敗,Quartz.NET 具有錯誤處理和重試技術。 在發生暫時故障或異常的情況下,開發人員可以設定重試原則和錯誤處理技術,以保證工作可以重試或重新排程。

聚類與可擴展性

由於 Quartz.NET 支援分散式作業排程中的群集,因此排程器的多個實體可以在伺服器群集中協調並執行任務。 這可透過實現水平擴充性和容錯,在分散式情境中保證可靠的工作排程和執行。

與 .NET Ecosystem 整合。

Quartz.NET 可輕鬆地與 .NET 生態系統銜接,其中包括訊息傳送系統 (Rebus.NET、MassTransit)、日誌框架 (Serilog、NLog) 以及流行的依賴注入框架 (Autofac、Microsoft.Extensions.DependencyInjection)。

建立與設定 Quartz.NET

定義工作和觸發器

針對您希望執行的任務,建立工作和觸發器。 要完成的任務由上下文物件和工作類別表示,工作執行的頻率和時間則由觸發器決定。

using Quartz;

// Define a job by implementing the IJob interface
public class MyJob : IJob
{
    public async Task Execute(IJobExecutionContext context)
    {
        // Implement the logic for your job here
    }
}

// Build the job instance using JobBuilder
var job = JobBuilder.Create<MyJob>()
    .WithIdentity("myJob", "group1") // Assign a unique name and group to the job
    .Build();

// Create a trigger to define when the job should be executed
var trigger = TriggerBuilder.Create()
    .WithIdentity("myTrigger", "group1") // Assign a unique name and group to the trigger
    .WithCronSchedule("0 0/5 * * * ?") // Run every 5 minutes based on the cron expression
    .Build();
using Quartz;

// Define a job by implementing the IJob interface
public class MyJob : IJob
{
    public async Task Execute(IJobExecutionContext context)
    {
        // Implement the logic for your job here
    }
}

// Build the job instance using JobBuilder
var job = JobBuilder.Create<MyJob>()
    .WithIdentity("myJob", "group1") // Assign a unique name and group to the job
    .Build();

// Create a trigger to define when the job should be executed
var trigger = TriggerBuilder.Create()
    .WithIdentity("myTrigger", "group1") // Assign a unique name and group to the trigger
    .WithCronSchedule("0 0/5 * * * ?") // Run every 5 minutes based on the cron expression
    .Build();
$vbLabelText   $csharpLabel

設定與初始化排程

使用指定的組態設定工作排程器以排程背景工作、工作和觸發器後,啟動排程器開始規劃和執行工作。

using Quartz;
using Quartz.Impl;

// Create a scheduler factory and get a scheduler instance
var schedulerFactory = new StdSchedulerFactory();
var scheduler = await schedulerFactory.GetScheduler(); 

// Start the scheduler
await scheduler.Start();

// Schedule the job with its corresponding trigger
await scheduler.ScheduleJob(job, trigger);
using Quartz;
using Quartz.Impl;

// Create a scheduler factory and get a scheduler instance
var schedulerFactory = new StdSchedulerFactory();
var scheduler = await schedulerFactory.GetScheduler(); 

// Start the scheduler
await scheduler.Start();

// Schedule the job with its corresponding trigger
await scheduler.ScheduleJob(job, trigger);
$vbLabelText   $csharpLabel

工作持久性

設定 Quartz.NET,將工作和觸發元資料儲存於持久性儲存庫中,就像資料庫一樣。 這可確保可靠性,並允許工作在應用程式重新啟動後仍能繼續執行。

錯誤處理

將錯誤處理和重試邏輯納入工作執行邏輯,以優雅的方式處理失敗。 Quartz.NET 提供內建的方法來管理異常和重試任務。

聚類

在分散式環境中使用 Quartz.NET 時,若要保證高可用性和可擴展性,請設定集群。 由於群集的緣故,排程器實例可以在伺服器群集之間協同執行任務。

依賴注入

如果您的應用程式使用依賴注入框架,請設定 Quartz.NET 與您的依賴注入 (DI) 容器通訊,以管理作業依賴、組態和生命週期。

IronPDF。

Quartz .NET (How It Works For Developers):圖 1 - IronPDF 網頁

IronPDF for .NET 這個著名的 .NET 套件讓在 .NET 程式中建立、修改和渲染 PDF 文件成為可能。 與 PDF 互動的功能眾多:從 HTML 內容、照片或未處理的資料建立 PDF; 將文字、影像和圖形附加到預先存在的 PDF 文件; 將 HTML 頁面轉換為 PDF; 以及從 PDF 中萃取文字和影像。

IronPDF 擅長於 HTML 至 PDF 的轉換,可確保精確保留原始版面與樣式。 它非常適合從網頁內容(如報告、發票和文件)建立 PDF。 IronPDF 支援 HTML 檔案、URL 和原始 HTML 字串,可輕鬆製作高品質的 PDF 文件。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert an HTML string to a PDF document
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert an HTML file to a PDF document
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert a URL to a PDF document
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert an HTML string to a PDF document
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert an HTML file to a PDF document
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert a URL to a PDF document
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
$vbLabelText   $csharpLabel

IronPDF 的簡易性和易用性是其兩大優點。 開發人員可以利用其友善的 API 和廣泛的說明文件,輕鬆地在其 .NET 專案中開始產生 PDF。 IronPDF 的速度和效率是其進一步的特點,可讓開發人員快速有效地製作高品質的 PDF 文件。

IronPDF。 核心功能

  • 從原始資料、HTML 和圖片建立 PDF。
  • 從 PDF 檔案中萃取文字和影像。
  • 允許您在 PDF 檔案中加入頁眉、頁腳和水印。
  • 建立具有密碼和加密安全性的 PDF 文件。
  • 提供填寫表格和數位簽名的工具。

使用 IronPDF 中的 Quartz 。

要開始在控制台或 ASP.NET Core 應用程式中使用 IronPDF 與 Quartz.NET,您可以使用 IronPDF 建立排程的背景工作,執行與 PDF 製作相關的任務。

安裝 Quartz 和 IronPDF 套件。

首先,確保您已透過 Visual Studio 套件管理員控制台,使用下列指令在 .NET 專案中安裝 IronPDF 和 Quartz.NET 所需的 NuGet 套件:

Install-Package Quartz
Install-Package IronPdf
Install-Package Quartz
Install-Package IronPdf
SHELL

程式碼範例

本節示範如何製作使用 IronPDF 建立 PDF 文件的 Quartz 作業。

using Quartz;
using IronPdf;

// Implementing a job that generates a PDF using IronPDF
public class PdfGenerationJob : IJob
{
    public async Task Execute(IJobExecutionContext context)
    {
        // Generating PDF using IronPDF
        var htmlContent = "<h1>Hello, IronPDF!</h1>";
        var pdfRenderer = new HtmlToPdf();
        var pdfDocument = pdfRenderer.RenderHtmlAsPdf(htmlContent);

        // Save the generated PDF to a file
        pdfDocument.SaveAs("output.pdf");
    }
}
using Quartz;
using IronPdf;

// Implementing a job that generates a PDF using IronPDF
public class PdfGenerationJob : IJob
{
    public async Task Execute(IJobExecutionContext context)
    {
        // Generating PDF using IronPDF
        var htmlContent = "<h1>Hello, IronPDF!</h1>";
        var pdfRenderer = new HtmlToPdf();
        var pdfDocument = pdfRenderer.RenderHtmlAsPdf(htmlContent);

        // Save the generated PDF to a file
        pdfDocument.SaveAs("output.pdf");
    }
}
$vbLabelText   $csharpLabel

設定 Quartz.NET 以利用觸發器在預定的排程中執行 PDF 建立程序。

// Create and configure the Quartz scheduler
var schedulerFactory = new StdSchedulerFactory();
var scheduler = await schedulerFactory.GetScheduler();
await scheduler.Start();

// Define the job and bind it to our PdfGenerationJob class
var job = JobBuilder.Create<PdfGenerationJob>()
    .WithIdentity("pdfGenerationJob", "pdfGenerationGroup")
    .Build();

// Define a trigger to schedule the PDF generation job
var trigger = TriggerBuilder.Create()
    .WithIdentity("pdfGenerationTrigger", "pdfGenerationGroup")
    .WithSimpleSchedule(x => x
        .WithIntervalInMinutes(30) // Run every 30 minutes
        .RepeatForever())
    .Build();

// Schedule the job using the scheduler
await scheduler.ScheduleJob(job, trigger);
// Create and configure the Quartz scheduler
var schedulerFactory = new StdSchedulerFactory();
var scheduler = await schedulerFactory.GetScheduler();
await scheduler.Start();

// Define the job and bind it to our PdfGenerationJob class
var job = JobBuilder.Create<PdfGenerationJob>()
    .WithIdentity("pdfGenerationJob", "pdfGenerationGroup")
    .Build();

// Define a trigger to schedule the PDF generation job
var trigger = TriggerBuilder.Create()
    .WithIdentity("pdfGenerationTrigger", "pdfGenerationGroup")
    .WithSimpleSchedule(x => x
        .WithIntervalInMinutes(30) // Run every 30 minutes
        .RepeatForever())
    .Build();

// Schedule the job using the scheduler
await scheduler.ScheduleJob(job, trigger);
$vbLabelText   $csharpLabel

要啟動 Quartz 排程器並開始執行計劃中的任務:

// Start the scheduler
await scheduler.Start();
// Optionally, monitor scheduler for job execution
// Start the scheduler
await scheduler.Start();
// Optionally, monitor scheduler for job execution
$vbLabelText   $csharpLabel

以下是上述程式碼產生的輸出。

Quartz .NET (How It Works For Developers):圖 2 - IronPDF 與 Quartz.NET 程式碼範例的輸出

結論

總而言之,Quartz.NET 與 IronPDF 的結合提供了一種強大的方式,可在 .NET 應用程式中自動執行與建立 PDF 相關的作業。 借助 Quartz.NET 功能強大且適應性強的排程系統,開發人員可以創建工作和觸發器,在預定的時間間隔或持續時間內執行活動。 另一方面,IronPDF 為開發人員提供了建立和處理 PDF 文件所需的所有工具。 開發人員可使用 HTML、圖形或原始資料,建立外觀專業的 PDF。

開發人員可透過整合 IronPDF 的 PDF 生成功能與 Quartz.NET 的排程功能,在分散式應用程式中自動執行典型的 PDF 生成作業,例如在預定的時間間隔或針對觸發器來建立報表、發票或文件。 此整合可簡化文件產生的工作流程、提高生產力並減少人工勞動,讓開發人員更輕鬆地製作並傳送高品質的 PDF 文件給客戶或客戶。

IronPDF 價格合理,若作為套件的一部分購買,則可獲得終身授權。 由於此套件只需 $799 的費用,也就是多個系統只需一次收費,因此提供了非凡的價值。 它為授權持有人提供全天候的線上工程協助。 若要瞭解 Iron Software 所生產的產品的更多資訊,請造訪 Iron Software 網站上的 Iron Software 產品頁面。

常見問題解答

如何在.NET應用程式中自動建立PDF檔案?

您可以透過將 Quartz.NET 與 IronPDF 整合來實現 PDF 的自動化建立。 Quartz.NET 負責任務調度,而 IronPDF 則可讓您從 HTML、影像或原始資料產生 PDF。

使用 Quartz.NET 進行任務排程有哪些好處?

Quartz.NET 提供了一個強大的任務調度框架,其功能包括靈活調度、基於觸發器的執行、作業持久化、並發控制、作業鏈、錯誤處理、重試技術以及用於可擴展性的叢集。

IronPDF 如何簡化 .NET 中的 PDF 產生?

IronPDF 提供使用者友好的 API,簡化了 PDF 生成流程,可將 HTML、圖像或原始資料轉換為 PDF 文件,非常適合用於報告、發票和文件。它能保留原始佈局和样式,確保高品質的輸出。

Quartz.NET 和 PDF 工具能否整合以增強工作流程自動化?

是的,將 Quartz.NET 與 IronPDF 等 PDF 工具集成,可以透過在 .NET 應用程式中安排和自動化 PDF 生成任務來增強工作流程自動化,從而提高效率和生產力。

Quartz.NET 中的作業持久化是什麼?它為什麼重要?

Quartz.NET 中的作業持久化是指將已排程作業及其歷史記錄儲存在資料庫中的能力,從而確保應用程式在發生故障或重新啟動後仍能正常運作。這對於維護作業排程和實作作業叢集至關重要。

如何在.NET應用程式中將HTML轉換為PDF?

您可以使用 IronPDF 的RenderHtmlAsPdf方法將 HTML 字串轉換為 PDF,或使用RenderHtmlFileAsPdf將 HTML 檔案直接轉換為 PDF。

Quartz.NET 支援哪些類型的排程模式?

Quartz.NET 支援各種調度模式,包括 cron 表達式,可精確控制執行時間並實現複雜的調度場景。

如何在我的.NET專案中安裝Quartz.NET和IronPDF?

使用 Visual Studio 套件管理器控制台,透過以下命令安裝 Quartz.NET 和 IronPDF: Install-Package QuartzInstall-Package IronPdf

IronPDF在PDF處理的核心功能有哪些?

IronPDF 提供從 HTML、圖像或原始資料建立 PDF、提取文字和圖像、新增頁首、頁尾和浮水印等功能,以及密碼保護等安全選項。

Quartz.NET 和 IronPDF 的整合如何增強 .NET 應用程式的功能?

將 Quartz.NET 與 IronPDF 集成,可實現 PDF 的自動生成和任務調度,從而簡化工作流程,提高 .NET 應用程式的生產力。

Jacob Mellor,Team Iron 首席技術官
首席技術長

Jacob Mellor 是 Iron Software 的首席技術官,也是一位富有遠見的工程師,率先開發了 C# PDF 技術。作為 Iron Software 核心程式碼庫的最初開發者,他自公司成立之初便參與塑造了其產品架構,並與執行長 Cameron Rimington 一起將其發展成為一家擁有 50 多名員工、服務於 NASA、特斯拉和全球政府機構的公司。

Jacob 於 1998 年至 2001 年在曼徹斯特大學獲得土木工程一級榮譽學士學位。 1999 年,他在倫敦創辦了自己的第一家軟體公司;2005 年,他創建了自己的第一個 .NET 元件。此後,他專注於解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF 和 IronSuite .NET 庫在全球 NuGet 上的安裝量已超過 3000 萬次,其基礎程式碼持續為全球開發者工具提供支援。憑藉 25 年的商業經驗和 41 年的程式設計專長,Jacob 始終致力於推動企業級 C#、Java 和 Python PDF 技術的創新,同時指導下一代技術領導者。