Sprint.Shared.ISOCode 1.0.0

Shared.ISOCode

Thailand Province ISO 3166-2 mapping library สำหรับระบบนิเวศ Sprint ใช้แปลงรหัสจังหวัด ISO (เช่น TH-10) เป็นชื่อจังหวัดทั้งภาษาไทยและอังกฤษ รองรับ .NET 6, 8 และ 10

✨ Features

• ครบ 77 จังหวัด — ข้อมูลจังหวัดไทยตามมาตรฐาน ISO 3166-2:TH ทุกจังหวัด
• สองภาษา — ชื่อภาษาไทยและภาษาอังกฤษพร้อมข้อมูลภาค
• Zero-allocation lookup — ใช้ Dictionary แบบ static ค้นหาเร็ว O(1)
• Case-insensitive — รองรับ TH-10, th-10 ได้เลย
• สองรูปแบบการใช้งาน — Static (ไม่ต้อง setup) และ DI (Injectable)
• Multi-framework — รองรับ .NET 6.0, 8.0 (LTS) และ 10.0

⚙️ Installation

dotnet add package Sprint.Shared.ISOCode

💡 Usage

1. Static Usage (ไม่ต้อง DI — ใช้งานได้ทันที)

using Shared.ISOCode.Thailand;

// แปลงรหัสเป็นชื่อจังหวัด
string? nameTh = ThailandProvince.GetNameTh("TH-10");  // "กรุงเทพมหานคร"
string? nameEn = ThailandProvince.GetNameEn("TH-10");  // "Bangkok"

// ดึงข้อมูลครบทุก field
var province = ThailandProvince.Get("TH-57");
Console.WriteLine(province?.NameTh);  // "เชียงราย"
Console.WriteLine(province?.NameEn);  // "Chiang Rai"
Console.WriteLine(province?.Region);  // "ภาคเหนือ"

// Pattern matching แบบ safe
if (ThailandProvince.TryGet("TH-83", out var phuket))
{
    Console.WriteLine(phuket!.NameEn);  // "Phuket"
}

// ดึงทั้งหมด (เรียงตาม code)
var all = ThailandProvince.GetAll();
foreach (var p in all.OrderBy(x => x.Code))
{
    Console.WriteLine($"{p.Code} | {p.NameTh} | {p.NameEn}");
}

2. DI Usage (ASP.NET Core / Hosted Services)

Program.cs

using Shared.ISOCode.Extensions;

builder.Services.AddThailandISOCode();

ใช้งานผ่าน Injection

using Shared.ISOCode.Resolvers;

public class OrderService(IProvinceResolver provinceResolver)
{
    public string GetShippingLabel(string isoCode)
    {
        var province = provinceResolver.Get(isoCode);
        return province is null
            ? "ไม่พบจังหวัด"
            : $"จัดส่งไปยัง: {province.NameTh} ({province.NameEn})";
    }
}

📋 Province Code Reference

ภาคกลาง (Central) — 25 จังหวัด

ภาคตะวันออก (Eastern) — 4 จังหวัด

ภาคเหนือ (Northern) — 14 จังหวัด

ภาคตะวันออกเฉียงเหนือ (Northeastern) — 20 จังหวัด

ภาคใต้ (Southern) — 14 จังหวัด

🗂️ Province Model

public sealed record Province(
    string Code,     // "TH-10"
    string NameTh,   // "กรุงเทพมหานคร"
    string NameEn,   // "Bangkok"
    string Region    // "ภาคกลาง"
);

🛡️ IProvinceResolver Interface

public interface IProvinceResolver
{
    Province? Get(string isoCode);
    string? GetNameTh(string isoCode);
    string? GetNameEn(string isoCode);
    bool TryGet(string isoCode, out Province? province);
    IReadOnlyCollection<Province> GetAll();
}

© 2026 Sprint-OMS Development Team