CountrySC 1.2.0

<p align="center"> <img src=".github/images/banner.svg" alt="CountrySC - offline Countries, States, Cities for .NET" width="100%" /> </p>

CountrySC

A lightweight .NET library providing a complete, offline dataset of countries, states/provinces, and cities — with ISO country codes, flag emojis, and international dial codes derived on the fly. No API calls, no network dependency; the dataset ships embedded (Brotli-compressed) inside the package.

Install

dotnet add package CountrySC

Targets net10.0.

Quick start

using CountrySC;

var geo = new CountrySCService();

// All countries, sorted alphabetically by name
IEnumerable<Country> countries = geo.GetAll();

// Look up a country by its 2-letter ISO code (case-insensitive)
Country? us = geo.GetByCountryCode("US");
Console.WriteLine($"{us!.FlagEmoji} {us.Name} (+{us.PhoneCode})"); // 🇺🇸 United States (+1)

// States/provinces for a country
IEnumerable<State> states = geo.GetStates("US");

// Cities for a given country + state id
var california = states.First(s => s.Name == "California");
IEnumerable<City> cities = geo.GetCities("US", california.Id);

// Find every country sharing an international dial code
IEnumerable<Country> plusOne = geo.GetByPhoneCode("+1"); // US, CA, ...

// IANA time zones for a country
IEnumerable<TimeZoneEntry> zones = geo.GetTimeZones("US"); // America/New_York, America/Chicago, ...
TimeSpan? offset = zones.First().CurrentUtcOffset;

// Official language(s) for a country
IEnumerable<string> languages = geo.GetLanguages("CH"); // French, German, Italian, Romansh

// Square SVG flag icon for a country (raw markup)
string flagSvg = geo.GetFlagSvg("US");

// Currency details for a country (e.g. United States Dollar, USD, $)
CountryCurrency? currency = geo.GetCurrency("US");

// Capital city of a country
string capital = geo.GetCapitalCity("US"); // Washington, D.C.

// Continent of a country
Continent? continent = geo.GetContinent("US"); // Continent.Americas

// Or via country properties:
string currencyName = us.Currency; // "United States Dollar"
string currencyIso = us.Iso4217;  // "USD"
string currencySymbol = us.Symbol; // "$"
string capitalCity = us.CapitalCity; // "Washington, D.C."
Continent continentProperty = us.Continent; // Continent.Americas

API

CountrySCService

Properties

• Country — Id, Name, States, plus computed properties:
  • CountryCode — ISO alpha-2 code, derived from the flag emoji's Unicode codepoints
  • FlagEmoji — the flag emoji (e.g. 🇺🇸)
  • PhoneCode — international dialing code (e.g. "1", "44")
  • Example — a sample local phone number for the country
  • DisplayName — "United States (US)"
  • TimeZones — the country's TimeZoneEntry list
  • OfficialLanguages — the country's official language name(s)
  • FlagSvg — raw SVG markup of the country's square flag icon, empty string if unavailable
  • Currency — name of the country's currency (e.g. "United States Dollar")
  • Iso4217 — three-letter ISO 4217 currency code (e.g. "USD")
  • Symbol — currency symbol (e.g. "$" or "€")
  • CapitalCity — capital city of the country (e.g. "Washington, D.C.")
  • Continent — continent where the country is located (Africa, Americas, Antarctica, Asia, Europe, Oceania)
• State — Id, Name, Cities
• City — Id, Name
• CountryCurrency — Currency (name of the currency), Iso4217 (three-letter code), Symbol (symbol)
• TimeZoneEntry — ZoneName (IANA identifier), CountryCode, plus computed properties:
  • BaseUtcOffset — standard (non-DST) UTC offset, resolved from the local system's time zone database
  • CurrentUtcOffset — UTC offset right now, including DST if in effect

Time zone data covers 246 countries/territories (418 zones total). Only IANA zone names are embedded; UTC offsets are resolved live via TimeZoneInfo so they stay correct across DST transitions instead of going stale.

Official language data covers 201 countries/territories. Coverage follows the source article and skips a handful of micro-territories and a few disputed/partially-recognized territories not present in the country dataset.

Currency data covers 250 countries/territories. Sourced from the Geocountries currency database (https://www.geocountries.com/country/currencies).

Capital city data covers 250 countries/territories. Sourced from Worlddata (https://www.worlddata.info/capital-cities.php).

Continent data covers 250 countries/territories. Sourced from Worlddata (https://www.worlddata.info/capital-cities.php).