CivicAddress Klasse

Definition

Namespace:

System.Device.Location

Assembly:

System.Device.dll

Stellt eine Adresse dar. Eine Adresse kann Felder wie Straße, Postleitzahl, Bundesland/Kanton und Land oder Region beinhalten.

public ref class CivicAddress

public class CivicAddress

type CivicAddress = class

Public Class CivicAddress

Vererbung

Object

CivicAddress

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie synchron von CivicAddress einem GeoCoordinate Speicherort aufgelöst werden.

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.");
                }
            }
        }
    }
}

Imports System.Device.Location

Module ResolveAddressSync

    Public Sub ResolveAddressSync()
        Dim watcher As GeoCoordinateWatcher
        watcher = New System.Device.Location.GeoCoordinateWatcher(GeoPositionAccuracy.High)
        Dim started As Boolean = False
        watcher.MovementThreshold = 1.0     'set to one meter
        started = watcher.TryStart(False, TimeSpan.FromMilliseconds(1000))

        Dim resolver As CivicAddressResolver = New CivicAddressResolver()
        If started Then
            If Not watcher.Position.Location.IsUnknown Then
                Dim address As CivicAddress = resolver.ResolveAddress(watcher.Position.Location)
                If Not address.IsUnknown Then
                    Console.WriteLine("Country: {0}, Zip: {1}",
                                address.CountryRegion,
                                address.PostalCode)
                Else
                    Console.WriteLine("Address unknown.")
                End If
            End If
        Else
            Console.WriteLine("GeoCoordinateWatcher timed out on start.")
        End If
    End Sub


    Public Sub Main()

        ResolveAddressSync()
        Console.WriteLine("Enter any key to quit.")
        Console.ReadLine()
    End Sub

End Module

Im folgenden Beispiel wird gezeigt, wie asynchron von CivicAddress einem GeoCoordinate Speicherort aufgelöst wird.

using System;
using System.Device.Location;
namespace ResolveAddressSync
{
    class AsyncProgram
    {
        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.");
            }
        }

    }
}

Imports System.Device.Location

Module ResolveCivicAddressAsync

    Public Sub ResolveCivicAddressAsync()
        Dim watcher As GeoCoordinateWatcher
        watcher = New System.Device.Location.GeoCoordinateWatcher(GeoPositionAccuracy.High)
        Dim started As Boolean = False
        watcher.MovementThreshold = 1.0     'set to one meter
        started = watcher.TryStart(False, TimeSpan.FromMilliseconds(1000))
        If started Then
            Dim resolver As CivicAddressResolver = New CivicAddressResolver()
            AddHandler resolver.ResolveAddressCompleted, AddressOf resolver_ResolveAddressCompleted
            If Not watcher.Position.Location.IsUnknown Then
                resolver.ResolveAddressAsync(watcher.Position.Location)
            End If
        End If

        watcher.Start()

    End Sub

    Sub resolver_ResolveAddressCompleted(ByVal sender As Object, ByVal e As ResolveAddressCompletedEventArgs)
        If Not e.Address.IsUnknown Then
            Console.WriteLine("Country: {0}, Zip: {1}",
                           e.Address.CountryRegion,
                           e.Address.PostalCode)
        Else
            Console.WriteLine("Unknown address.")
        End If
    End Sub


    Public Sub Main()

        ResolveCivicAddressAsync()
        Console.WriteLine("Enter any key to quit.")
        Console.ReadLine()
    End Sub

End Module

Hinweise

Eine Bürgeradresse für einen Standort kann mithilfe einer GeoCoordinate -Klasse abgerufen werden, die implementiert ICivicAddressResolver.

Die CivicAddressResolver -Klasse stellt eine Standardimplementierung bereit, die die zivile Adresse zurückgibt, die einem GeoCoordinateentspricht, wenn die Standortquelle sowohl Koordinatendaten als auch Ziviladressdaten bereitstellt.

ResolveAddress gibt einen CivicAddress für den aktuellen Speicherort zurück. Wenn die Standortquelle die Koordinatenposition nicht in eine Bürgeradresse auflösen kann, Unknown wird zurückgegeben.

Konstruktoren

CivicAddress()	Initialisiert eine neue Instanz der CivicAddress-Klasse.
CivicAddress(String, String, String, String, String, String, String, String)	Initialisiert eine neue Instanz der CivicAddress-Klasse mithilfe der Adressinformationen.

Felder

Unknown

Stellt ein CivicAddress dar, das keine Daten enthält.

Eigenschaften

AddressLine1	Ruft die erste Zeile der Adresse ab oder legt diese fest.
AddressLine2	Ruft die zweite Zeile der Adresse ab oder legt diese fest.
Building	Ruft den Gebäudenamen bzw. die Hausnummer ab oder legt diese Angabe fest.
City	Ruft den Namen der Stadt ab oder legt diesen fest.
CountryRegion	Ruft das Land oder die Region der Position ab bzw. legt diese Angabe fest.
FloorLevel	Ruft die Etage im Gebäude ab oder legt diese fest.
IsUnknown	Ruft einen Wert ab, der angibt, ob die CivicAddress Daten enthält.
PostalCode	Ruft die Postleitzahl der Position ab oder legt diese fest.
StateProvince	Ruft das Bundesland bzw. den Kanton der Position oder legt diese Angabe fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)