‫تجزیه با الگوی Result، رویکردی قدرتمند در برنامه‌نویسی .NET

• تکرار: منطق اعتبارسنجی باید در نقاط مختلف برنامه تکرار شود، که می‌تواند به کد تکراری (Boilerplate Code) منجر شود.
• عدم اطمینان: حتی پس از اعتبارسنجی، داده ممکن است در مراحل بعدی تغییر کند و نامعتبر شود، زیرا هیچ مکانیزمی برای حفظ صحت آن وجود ندارد.
• پیچیدگی: شرط‌های پراکنده در کد، خوانایی و نگهداری را دشوار می‌کنند و منطق اصلی برنامه را تحت‌الشعاع قرار می‌دهند.

public abstract class Result<T>
{
    public static Success<T> Ok(T value) => new Success<T>(value);
    public static Failure<T> Fail(string error) => new Failure<T>(error);
}

public class Success<T> : Result<T>
{
    public T Value { get; }
    public Success(T value) => Value = value;
}

public class Failure<T> : Result<T>
{
    public string Error { get; }
    public Failure(string error) => Error = error;
}

public bool IsValidEmail(string email)
{
    if (string.IsNullOrEmpty(email)) return false;
    return email.Contains("@") && email.Contains(".");
}

public void SendEmail(string email)
{
    if (!IsValidEmail(email))
        throw new ArgumentException("Invalid email address");
    // ارسال ایمیل
}

public class EmailAddress
{
    private readonly string _value;

    private EmailAddress(string value)
    {
        _value = value;
    }

    public static Result<EmailAddress> Parse(string input)
    {
        if (string.IsNullOrEmpty(input) || !input.Contains("@") || !input.Contains("."))
            return Result<EmailAddress>.Fail("فرمت ایمیل نامعتبر است");
        return Result<EmailAddress>.Ok(new EmailAddress(input));
    }

    public string Value => _value;

    public override string ToString() => _value;
}

public void SendEmail(EmailAddress email)
{
    // ارسال ایمیل بدون نیاز به بررسی اضافی
}

// استفاده
var result = EmailAddress.Parse("user@example.com");
if (result is Success<EmailAddress> success)
    SendEmail(success.Value);
else if (result is Failure<EmailAddress> failure)
    Console.WriteLine(failure.Error);

public class AdultBirthDate
{
    private readonly DateTime _value;

    private AdultBirthDate(DateTime value)
    {
        _value = value;
    }

    public static Result<AdultBirthDate> Parse(DateTime input)
    {
        if (input >= DateTime.Now || (DateTime.Now.Year - input.Year) < 18)
            return Result<AdultBirthDate>.Fail("کاربر باید حداقل 18 سال داشته باشد");
        return Result<AdultBirthDate>.Ok(new AdultBirthDate(input));
    }

    public DateTime Value => _value;
}

public void RegisterUser(AdultBirthDate birthDate)
{
    // ثبت کاربر بدون نیاز به بررسی اضافی
}

// استفاده
var result = AdultBirthDate.Parse(new DateTime(2000, 1, 1));
if (result is Success<AdultBirthDate> success)
    RegisterUser(success.Value);
else if (result is Failure<AdultBirthDate> failure)
    Console.WriteLine(failure.Error);

1. ایمنی نوع‌ها: نوع‌های سفارشی ذاتاً معتبر هستند و نیازی به بررسی اضافی ندارند.
2. مدیریت خطا: الگوی Result خطاها را به صورت شفاف و بدون استثناء مدیریت می‌کند.
3. کاهش پیچیدگی: حذف اعتبارسنجی‌های پراکنده، کد را متمرکز و خواناتر می‌کند.
4. قابلیت استفاده مجدد: نوع‌های تعریف‌شده در سراسر برنامه قابل استفاده هستند.

• تغییرناپذیری (Immutability): نوع‌های سفارشی باید تغییرناپذیر باشند تا از دستکاری غیرمنتظره جلوگیری شود.
• کنترل جریان: استفاده از تطابق الگو (Pattern Matching) در C# برای بررسی نتایج، کد را ساده‌تر می‌کند.
• انعطاف‌پذیری: می‌توانید متدهایی مانند TryParse اضافه کنید که مشابه int.TryParse عمل کنند.