CivicAddress Class
Represents a civic address. A civic address can include fields such as street address, postal code, state/province, and country or region.
Namespace: System.Device.Location
Assembly: System.Device (in System.Device.dll)
The CivicAddress type exposes the following members.
| Name | Description | |
|---|---|---|
 | CivicAddress() | Initializes a new instance of the CivicAddress class. |
| CivicAddress(String, String, String, String, String, String, String, String) | Initializes a new instance of the CivicAddress class using address information. |
| Name | Description | |
|---|---|---|
| AddressLine1 | Gets or sets the first line of the address. |
| AddressLine2 | Gets or sets the second line of the address. |
| Building | Gets or sets the building name or number. |
| City | Gets or sets the name of the city. |
| CountryRegion | Gets or sets the country or region of the location. |
| FloorLevel | Gets or sets the floor level of the location. |
| IsUnknown | Gets a value that indicates whether the CivicAddress contains data. |
| PostalCode | Gets or sets the postal code of the location. |
| StateProvince | Gets or sets the state or province of the location. |
| Name | Description | |
|---|---|---|
| Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
| Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
A civic address for a location can be obtained from a GeoCoordinate by using a class that implements ICivicAddressResolver.
The CivicAddressResolver class provides a default implementation that returns the civic address that corresponds to a GeoCoordinate, if the location source provides both coordinate data as well as civic address data.
ResolveAddress returns a CivicAddress for the current location. If the location source is unable to resolve the coordinate position to a civic address, Unknown is returned.
The following example shows how to resolve a CivicAddress from a GeoCoordinate location synchronously.
using System; using System.Device.Location; namespace ResolveAddressSync { class Program { static void Main(string[] args) { ResolveAddressSync(); } static void ResolveAddressSync() { GeoCoordinateWatcher watcher = new GeoCoordinateWatcher(GeoPositionAccuracy.High); watcher.MovementThreshold = 1.0; // set to one meter watcher.TryStart(false, TimeSpan.FromMilliseconds(1000)); CivicAddressResolver resolver = new CivicAddressResolver(); if (watcher.Position.Location.IsUnknown == false) { CivicAddress address = resolver.ResolveAddress(watcher.Position.Location); if (!address.IsUnknown) { Console.WriteLine("Country: {0}, Zip: {1}", address.CountryRegion, address.PostalCode); } else { Console.WriteLine("Address unknown."); } } } } }
The following example shows how to resolve a CivicAddress from a GeoCoordinate location asynchronously.
using System; using System.Device.Location; namespace ResolveAddressSync { class Program { public static void Main(string[] args) { ResolveAddressAsync(); } static void ResolveAddressAsync() { GeoCoordinateWatcher watcher = new GeoCoordinateWatcher(GeoPositionAccuracy.High); bool started = false; watcher.MovementThreshold = 1.0; // set to one meter started = watcher.TryStart(false, TimeSpan.FromMilliseconds(1000)); if (started) { CivicAddressResolver resolver = new CivicAddressResolver(); resolver.ResolveAddressCompleted += new EventHandler<ResolveAddressCompletedEventArgs>(resolver_ResolveAddressCompleted); if (watcher.Position.Location.IsUnknown == false) { resolver.ResolveAddressAsync(watcher.Position.Location); } } } static void resolver_ResolveAddressCompleted(object sender, ResolveAddressCompletedEventArgs e) { if (!e.Address.IsUnknown) { Console.WriteLine("Country: {0}, Zip: {1}", e.Address.CountryRegion, e.Address.PostalCode); } else { Console.WriteLine("Unknown address."); } } } }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
