Flunt C#（對於開發者的運行原理）

How to use Flunt in C#

1. 創建一個新的C#控制台專案。
2. 從NuGet安裝Flunt套件。
3. 匯入命名空間並繼承類別。
4. 將驗證添加到數據模型中。
5. 執行驗證檢查並顯示結果。

Understanding of Flunt C#

Flunt是一個多功能且輕量的.NET框架，旨在促進C#應用程式中流暢驗證和通知模式的開發。 當開發者使用Flunt以流利且具表達性的方式構建驗證規則和業務邏輯時，代碼變得更易讀且易於維護。 使用Flunt的廣泛集成驗證技術和擴展功能，開發者可以輕鬆驗證複雜的數據結構，如對象和集合。

此外，由於Flunt可以輕鬆與當前代碼庫和框架集成，因此它是提高.NET程式庫應用程式可靠性和穩定性的有用工具。 總的來說，Flunt鼓勵使用一種聲明式的驗證和錯誤處理方式，使開發者能夠撰寫更乾淨、更穩健的代碼。

Getting Started with Flunt C#

Flunt C#範例

Flunt一旦安裝完畢，您可以使用以下代碼。 這是一個簡單的範例，展示您如何使用Flunt構建驗證規則：

using System;
using Flunt.Validations;

public class Program
{
    static void Main(string[] args)
    {
        var person = new Person { Name = "Jack", Age = -25 };
        var contract = new PersonContract(person);

        // Perform validation checks
        if (contract.IsValid)
        {
            Console.WriteLine("Person is valid!");
        }
        else
        {
            Console.WriteLine("Validation failed:");
            foreach (var notification in contract.Notifications)
            {
                Console.WriteLine($"- {notification.Key}: {notification.Message}");
            }
        }
    }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public class PersonContract : Contract<Person>
{
    public PersonContract(Person person)
    {
        // Ensure the correct format of the object
        Requires()
            .IsNotNull(person, nameof(person))
            .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
            .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
    }
}

using System;
using Flunt.Validations;

public class Program
{
    static void Main(string[] args)
    {
        var person = new Person { Name = "Jack", Age = -25 };
        var contract = new PersonContract(person);

        // Perform validation checks
        if (contract.IsValid)
        {
            Console.WriteLine("Person is valid!");
        }
        else
        {
            Console.WriteLine("Validation failed:");
            foreach (var notification in contract.Notifications)
            {
                Console.WriteLine($"- {notification.Key}: {notification.Message}");
            }
        }
    }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public class PersonContract : Contract<Person>
{
    public PersonContract(Person person)
    {
        // Ensure the correct format of the object
        Requires()
            .IsNotNull(person, nameof(person))
            .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
            .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
    }
}

Person 類別：表示具有 Name 和 Age 屬性的實體。

PersonContract：這個類來自於Flunt的基本概念 Contract<t>。 使用Person對象並提供驗證規則。 Requires提供了一種鏈式方法來定義多個驗證。 驗證由IsGreaterThan等方法執行。 每個驗證規則都有一個相關的自定義錯誤消息。

驗證：類似於Person對象的實例。 驗證結果由契約的IsValid屬性顯示。 根據驗證結果顯示成功或失敗的通知，以及特定的錯誤消息。

Flunt 操作

為了在C#應用程式中進行驗證和通知處理，Flunt提供了許多操作，例如：

創建驗證規則：使用流暢介面創建屬性如必填字段、數據類型、值範圍、最大長度和最小長度的驗證規則。

執行驗證：將對象與預定義規則進行驗證以確保數據完整性和遵循業務邏輯。

管理驗證錯誤：記錄驗證錯誤並將其作為警告記錄，並通過向用戶提供錯誤消息或記錄錯誤以進行故障排除給予恰當的響應。

自定義驗證邏輯：針對複雜的驗證情況或特定領域需求擴展Flunt以使用唯一的驗證規則。

與框架的集成： Flunt可以無縫集成到多個知名的.NET框架和程式庫中，包括Entity Framework、ASP.NET Core等，以增強現有應用程式的驗證能力。

將Flunt與IronPDF整合

通過將Flunt與IronPDF整合，開發者可以發揮這兩種技術的優勢，以加速C#應用程式中的業務邏輯驗證和文件創建。 開發者可以通過在使用Flunt驗證輸入數據後使用IronPDF創建PDF文件，讓應用程式更加可靠和使用者友好。

安裝 IronPDF

• 啟動Visual Studio專案。
• 選擇"工具">"NuGet套件管理器">"套件管理控制台"。
• 在套件管理控制台中輸入此命令：

Install-Package IronPdf

• 另外，您可以使用NuGet套件管理器來安裝IronPDF和其他必要的NuGet套件。
• 在搜尋結果中探索並選擇IronPDF套件後，點擊"安裝"按鈕。 安裝和下載將由Visual Studio處理。

• NuGet將處理您的專案所需的IronPDF套件及任何依賴項的安裝。
• 安裝後，IronPDF可供您的專案使用。

實現邏輯

讓我們創建一個使用IronPDF進行PDF創建和使用Flunt進行數據驗證的基本C#應用程式。 在這個範例中，我們將使用Flunt驗證註冊表單的用戶輸入，並使用IronPDF創建一份已驗證用戶數據摘要的PDF文件。

1. Person類別： 定義一個具有姓名和年齡屬性的Person類別。 透過在構造函數中使用Flunt的流暢介面，我們將Person數據與預定義的驗證規則進行驗證。
2. 生成Pdf： 定義一個名為RenderHtmlAsPdf的方法，接受一個User對象作為輸入。 該函數使用IronPDF的HtmlToPdf類別將用戶註冊摘要表示為HTML文本渲染成PDF文件。
3. Main方法： 使用範例Person數據，我們在Main方法中構建User類別的實例。 接下來，我們使用Flunt的IsValid屬性來確定Person數據是否合法。 如果數據正確，我們將調用IronPdf方法來創建PDF文檔。 如果不正確，控制台上將顯示驗證問題。

通過將IronPDF與Flunt結合進行PDF生成和數據驗證，我們已經開發出一個快速的工作流程，用於在C#應用程式中評估用戶輸入和生成PDF文件。 此方法確保數據完整性，生成專業品質的文件，並促進編寫清晰、可讀和可維護的代碼。 要閱讀有關IronPDF功能的更多信息，請參閱說明文件頁面。 以下是示例代碼片段。

using IronPdf;
using System;
using System.Linq;
using System.Text;
using Flunt.Validations;

namespace ConsoleApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // StringBuilder for HTML content
            StringBuilder sb = new StringBuilder();
            var person = new Person { Name = "Jack", Age = -25 };
            var contract = new PersonContract(person);

            if (contract.IsValid)
            {
                Console.WriteLine("Person is valid!");
                sb.Append("<p>Person is valid!</p>");
            }
            else
            {
                sb.Append("<p>Validation failed: </p>");
                foreach (var notification in contract.Notifications)
                {
                    sb.Append($"- {notification.Key}: {notification.Message}<br>");
                }
            }

            var renderer = new HtmlToPdf();
            // Set HTML content for the page
            var pdfDocument = renderer.RenderHtmlAsPdf(sb.ToString());
            // Save the document
            pdfDocument.SaveAs("output.pdf");
            // Dispose the renderer object
            renderer.Dispose();
            // Display a message
            Console.WriteLine("Report generated successfully!");
        }
    }

    public class Person
    {
        public string Name { get; set; }
        public int Age { get; set; }
    }

    public class PersonContract : Contract<Person>
    {
        public PersonContract(Person person)
        {
            Requires()
                .IsNotNull(person, nameof(person))
                .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
                .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
        }
    }
}

using IronPdf;
using System;
using System.Linq;
using System.Text;
using Flunt.Validations;

namespace ConsoleApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // StringBuilder for HTML content
            StringBuilder sb = new StringBuilder();
            var person = new Person { Name = "Jack", Age = -25 };
            var contract = new PersonContract(person);

            if (contract.IsValid)
            {
                Console.WriteLine("Person is valid!");
                sb.Append("<p>Person is valid!</p>");
            }
            else
            {
                sb.Append("<p>Validation failed: </p>");
                foreach (var notification in contract.Notifications)
                {
                    sb.Append($"- {notification.Key}: {notification.Message}<br>");
                }
            }

            var renderer = new HtmlToPdf();
            // Set HTML content for the page
            var pdfDocument = renderer.RenderHtmlAsPdf(sb.ToString());
            // Save the document
            pdfDocument.SaveAs("output.pdf");
            // Dispose the renderer object
            renderer.Dispose();
            // Display a message
            Console.WriteLine("Report generated successfully!");
        }
    }

    public class Person
    {
        public string Name { get; set; }
        public int Age { get; set; }
    }

    public class PersonContract : Contract<Person>
    {
        public PersonContract(Person person)
        {
            Requires()
                .IsNotNull(person, nameof(person))
                .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
                .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
        }
    }
}

以下是以上代碼的執行輸出：

結論

IronPDF和Flunt是兩個強大的C#函式庫，它們協同工作以簡化文件創建和數據驗證的工作流程。 借助IronPDF的高級PDF生成功能和Flunt的強大驗證能力，開發者可以構建針對各種應用程式的可靠、有效和高品質的解決方案。 無論是開發桌面應用、Web應用程式還是雲端解決方案，Flunt和IronPDF都為開發者提供了創建滿足用戶和利益相關者需求的高品質軟體所需的工具。

在$799 Lite套件中包括了一年的軟體支援、永久授權和函式庫升級。 IronPDF提供免費授權詳情以了解更多有關成本和授權需求的信息。 要了解有關Iron Software程式庫的更多信息，請訪問<Iron Software官方網站。