Flunt C#（開発者向けの動作方法）

C# で Flunt を使用する方法

1. 新しいC#コンソールプロジェクトを作成します。
2. NuGetからFluntパッケージをインストールします。
3. 名前空間をインポートし、クラスを継承します。
4. データモデルに検証を追加します。
5. 検証チェックを実行して結果を表示します。

Flunt C# の概要

Fluntはフルーエントな検証と通知パターンの開発を容易にするために作成された、柔軟で軽量な.NETフレームワークです。 開発者がFluntを使用して流暢で表現力豊かな方法で検証ルールとビジネスロジックを構築すると、コードはより読みやすく保守されやすくなります。 Fluntの広範な統合検証技法と拡張機能により、開発者はオブジェクトやコレクションのような複雑なデータ構造を簡単に検証できます。

さらに、Fluntは現在のコードベースやフレームワークと簡単に統合できるため、.NETライブラリアプリケーションの信頼性と堅牢性を向上させるのに役立ちます。 全体として、Fluntは宣言的アプローチを奨励し、エラーハンドリングを行うことで、開発者がクリーンで堅牢なコードを書くことを可能にします。

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

Imports System
Imports Flunt.Validations

Public Class Program
	Shared Sub Main(ByVal args() As String)
		Dim person As New Person With {
			.Name = "Jack",
			.Age = -25
		}
		Dim contract = New PersonContract(person)

		' Perform validation checks
		If contract.IsValid Then
			Console.WriteLine("Person is valid!")
		Else
			Console.WriteLine("Validation failed:")
			For Each notification In contract.Notifications
				Console.WriteLine($"- {notification.Key}: {notification.Message}")
			Next notification
		End If
	End Sub
End Class

Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class

Public Class PersonContract
	Inherits Contract(Of Person)

	Public Sub New(ByVal person As 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")
	End Sub
End Class

Person クラス: Name および Age プロパティを持つエンティティを表します。

PersonContract:このクラスは、Flunt の基本概念である Contract<t> から派生しています。 コンストラクターは、Requires メソッドを使用して、Person オブジェクトを受け取り、検証ルールを提供します。 Requires は、複数の検証を定義するための連鎖可能なメソッドを提供します。 検証は、IsGreaterThan などの方法で実行されます。 各検証ルールには関連するカスタムエラーメッセージがあります。

検証: FluentValidation の例と同様に、これは PersonContract および Person オブジェクトのインスタンスを作成します。 検証結果は、契約の IsValid 属性によって表示されます。 検証結果に基づいて成功または失敗の通知、および特定のエラーメッセージが表示されます。

Fluntの操作

C#アプリケーションでの検証と通知処理のために、Fluntは次のような多くの操作を提供します。

検証ルールの作成: 必須フィールド、データ型、値範囲、最大長、最少長のような属性のための検証ルールを作成するために、フルーエントインターフェースを使用します。

検証の実行: データの完全性とビジネスロジックの遵守を保証するために、オブジェクトを事前定義されたルールに対して検証します。

検証ミスの管理: 検証ミスをアラートとして記録し、ユーザーにエラーメッセージを提供したり、トラブルシューティングのためにエラーを記録したりすることで優雅に対応します。

カスタム検証ロジック: 複雑な検証状況や特定のドメイン要件に応じてFluntを拡張し、独自の検証ルールを使用します。

フレームワークとの統合: 現在のアプリケーションに検証機能を向上させるために、FluntはEntity FrameworkやASP.NET Coreなど、よく知られた.NETフレームワークやライブラリとシームレスに統合できます。

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を使用し、確認済みのユーザーデータの概要をPDF文書にするためにIronPDFを使用します。

1. Personクラス: 名前と年齢の属性を持つPersonクラスが定義されています。 Fluntの流暢なインターフェースを使用して、コンストラクタで事前定義された検証ルールに対してPersonデータを検証します。
2. PDF の生成: RenderHtmlAsPdf というメソッドが定義されており、User オブジェクトを入力として受け入れます。 この関数は、IronPDF の HtmlToPdf クラスを使用して、ユーザー登録の概要を表す HTML テキストを PDF ドキュメントに変換します。
3. メインメソッド: MainメソッドでサンプルのPersonデータを使用してUserクラスのインスタンスを構築します。 次に、Flunt の IsValid 属性を使用して、Person データが正当かどうかを判断します。 データが正しい場合はIronPdfメソッドを呼び出し、PDF文書を作成します。 そうでない場合は、検証の問題がコンソールに表示されます。

IronPDFをPDF生成に使用し、Fluntをデータ検証に使用することで、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");
        }
    }
}

Imports IronPdf
Imports System
Imports System.Linq
Imports System.Text
Imports Flunt.Validations

Namespace ConsoleApp
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' StringBuilder for HTML content
			Dim sb As New StringBuilder()
			Dim person As New Person With {
				.Name = "Jack",
				.Age = -25
			}
			Dim contract = New PersonContract(person)

			If contract.IsValid Then
				Console.WriteLine("Person is valid!")
				sb.Append("<p>Person is valid!</p>")
			Else
				sb.Append("<p>Validation failed: </p>")
				For Each notification In contract.Notifications
					sb.Append($"- {notification.Key}: {notification.Message}<br>")
				Next notification
			End If

			Dim renderer = New HtmlToPdf()
			' Set HTML content for the page
			Dim 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!")
		End Sub
	End Class

	Public Class Person
		Public Property Name() As String
		Public Property Age() As Integer
	End Class

	Public Class PersonContract
		Inherits Contract(Of Person)

		Public Sub New(ByVal person As 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")
		End Sub
	End Class
End Namespace

以下は上のコードからの実行出力です。

結論

IronPDFとFluntは、ドキュメント作成とデータ検証のワークフローを効率化するためにうまく協力する強力なC#ライブラリです。 IronPDFの高度なPDF生成機能とFluntの強力な検証機能を使用して、開発者はさまざまなアプリケーションのための信頼性が高く、効果的で高品質のソリューションを構築することができます。 FluntとIronPDFは、デスクトップアプリ、ウェブアプリ、またはクラウドベースのソリューションを開発する場合に、高品質のソフトウェアを作成するために必要なツールを開発者に提供します。

$999 Lite バンドルには、1 年間のソフトウェア サポート、永久ライセンス、ライブラリ アップグレードがすべて含まれています。 IronPDFは、費用とライセンス要件に関する詳細についてはさらなる無料のライセンス情報を提供しています。 Iron Softwareライブラリの詳細については、Iron Software公式ウェブサイトを訪れてください。