Countries and regions

3 min

Use countries and regions when configuring marketsmarkets and tax jurisdictions, or on the front end when working with ordersorders. Installation creates an extensive list of countries.

Classes in this topic are in the following namespaces:

Mediachase.Commerce.Orders

Mediachase.Commerce.Orders.Dto

Mediachase.Commerce.Orders.Managers

Create countries and regions

The following example creates a country and an associated region:

var dto = new CountryDto();
var countryRow = dto.Country.NewCountryRow();
countryRow.Name = "Country Name";
countryRow.Code = "AAA"; // Three-digit country code.
countryRow.Ordering = 0;
countryRow.Visible = true;
if (countryRow.RowState == DataRowState.Detached)
  dto.Country.Rows.Add(countryRow);
dto.EnforceConstraints = false;

var region = dto.StateProvince.NewStateProvinceRow();
region.Name = "My Region";
region.Ordering = 0;
region.Visible = true;
region.CountryId = dto.Country[0].CountryId;
if (region.RowState == DataRowState.Detached)
  dto.StateProvince.Rows.Add(region);
dto.EnforceConstraints = true;

CountryManager.SaveCountry(dto);

Update countries and regions

The following example updates the ordering and visibility of a country and adjusts the ordering of one of its regions:

var dto = CountryManager.GetCountry("USA", true);
var countryRow = dto.Country[0];
countryRow.Ordering = 20;
countryRow.Visible = false;

var ca = countryRow.GetStateProvinceRows().FirstOrDefault(x => x.Name.Equals("California"));
ca.Ordering = 5;

CountryManager.SaveCountry(dto);

Delete countries and regions

The following example deletes a country:

var dto = CountryManager.GetCountry("USA", true);
var countryRow = dto.Country[0];
countryRow.Delete();
CountryManager.SaveCountry(dto);