GeoCoordinateWatcher-Klasse

Die GeoCoordinateWatcher-Klasse stellt koordinatenbasierte Standortdaten des aktuellen Standortanbieters zur Verfügung. Der aktuelle Positionsanbieter wird auf Grundlage mehrerer Faktoren am höchsten auf dem Computer priorisiert. Hierzu zählen das Alter und die Genauigkeit der Daten von allen Anbietern, die von Positionsanwendungen angeforderte Genauigkeit und der Energieverbrauch und die Leistungsauswirkungen des Positionsanbieters. Der aktuelle Speicherortanbieter ändert sich möglicherweise im Lauf der Zeit, wenn beispielsweise ein GPS-Gerät im Haus sein Satellitensignal verliert, und ein Wi-Fi-Triangulationsanbieter der genauste Anbieter auf dem Computer wird.

Um mit dem Zugriff auf Speicherortdaten zu beginnen, erstellen Sie einen GeoCoordinateWatcher, und rufen Sie Start oder TryStart auf, um das Abrufen der Daten vom aktuellen Speicherortanbieter zu initiieren.

Die Status-Eigenschaft kann überprüft werden, um zu bestimmen, ob Daten verfügbar sind. Wenn Daten verfügbar sind, können Sie einmal den Speicherort aus der Position-Eigenschaft abrufen oder fortlaufende Speicherortupdates durch Behandeln des PositionChanged-Ereignisses abrufen.

Die Eigenschaften Permission, Status und Position unterstützen INotifyPropertyChanged, damit eine Anwendung Datenbindung an diese Eigenschaften vornehmen kann.

In Windows 7 sind alle System.Device.Location-Klassen vollständig funktional, wenn ein Standortanbieter installiert ist und den Standort des Computers auflösen kann.

Hinweis
Unter Windows 7 Starter Edition ist der einzige unterstützte Speicherortanbieter der Standardspeicherortanbieter in der Systemsteuerung, und ein Add-In muss installiert sein, um die Breite und Länge anzugeben.

Hinweis   In Versionen von Windows vor Windows 7 gelten die folgenden Bedingungen:

• Alle System.Device.Location-Objekte mit Konstruktoren können erstellt werden, aber die Status-Eigenschaft verfügt immer über den Wert Disabled.

• Der von der Location-Eigenschaft von Position angegebene Standort ist immer Unknown.

• Keine Standortereignisse werden ausgelöst.

Das folgende Programm veranschaulicht, wie ein GeoCoordinateWatcher erstellt und die Datensammlung mit einem Initialisierungstimeout gestartet wird. Im Code werden dann die Koordinaten des Speicherorts gedruckt, wenn bekannt.

using System;
using System.Device.Location;

namespace GetLocationProperty
{
    class Program
    {
        static void Main(string[] args)
        {
            GetLocationProperty();
        }

        static void GetLocationProperty()
        {
            GeoCoordinateWatcher watcher = new GeoCoordinateWatcher();

            // Do not suppress prompt, and wait 1000 milliseconds to start.
            watcher.TryStart(false, TimeSpan.FromMilliseconds(1000));

            GeoCoordinate coord = watcher.Position.Location;

            if (coord.IsUnknown != true)
            {
                Console.WriteLine("Lat: {0}, Long: {1}",
                    coord.Latitude,
                    coord.Longitude);
            }
            else
            {
                Console.WriteLine("Unknown latitude and longitude.");
            }
        }
    }
}

Das folgende Programm veranschaulicht, wie fortlaufende Ortungsupdates durch das Abonnieren von PositionChanged-Ereignissen empfangen werden.

using System;
using System.Device.Location;

namespace GetLocationEvent
{
    class Program
    {
        static void Main(string[] args)
        {
            CLocation myLocation = new CLocation();
            myLocation.GetLocationEvent();
            Console.WriteLine("Enter any key to quit.");
            Console.ReadLine();            
        }
        class CLocation
        {
            GeoCoordinateWatcher watcher;

            public void GetLocationEvent()
            {
                this.watcher = new GeoCoordinateWatcher();
                this.watcher.PositionChanged += new EventHandler<GeoPositionChangedEventArgs<GeoCoordinate>>(watcher_PositionChanged);
                bool started = this.watcher.TryStart(false, TimeSpan.FromMilliseconds(2000));
                if (!started)
                {
                    Console.WriteLine("GeoCoordinateWatcher timed out on start.");
                }
            }

            void watcher_PositionChanged(object sender, GeoPositionChangedEventArgs<GeoCoordinate> e)
            {
                PrintPosition(e.Position.Location.Latitude, e.Position.Location.Longitude);
            }

            void PrintPosition(double Latitude, double Longitude)
            {
                Console.WriteLine("Latitude: {0}, Longitude {1}", Latitude, Longitude);
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz