GeoCoordinateWatcher Klasse

Definition

public ref class GeoCoordinateWatcher : IDisposable, System::ComponentModel::INotifyPropertyChanged, System::Device::Location::IGeoPositionWatcher<System::Device::Location::GeoCoordinate ^>

[System.Security.SecurityCritical]
public class GeoCoordinateWatcher : IDisposable, System.ComponentModel.INotifyPropertyChanged, System.Device.Location.IGeoPositionWatcher<System.Device.Location.GeoCoordinate>

[<System.Security.SecurityCritical>]
type GeoCoordinateWatcher = class
    interface IDisposable
    interface INotifyPropertyChanged
    interface IGeoPositionWatcher<GeoCoordinate>

Public Class GeoCoordinateWatcher
Implements IDisposable, IGeoPositionWatcher(Of GeoCoordinate), INotifyPropertyChanged

Vererbung

Object

GeoCoordinateWatcher

Attribute

SecurityCriticalAttribute

Implementiert

INotifyPropertyChanged IGeoPositionWatcher<GeoCoordinate> IDisposable

Beispiele

Das folgende Programm zeigt, wie Sie ein GeoCoordinateWatcher -Objekt erstellen und mit dem Abrufen von Daten mithilfe eines Initialisierungstimeouts beginnen. Der Code gibt dann die Koordinaten der Position aus, sofern 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.");
            }
        }
    }
}

Imports System.Device.Location

Module GetLocationProperty
    Public Sub GetLocationProperty()
        Dim watcher As New System.Device.Location.GeoCoordinateWatcher()
        watcher.TryStart(False, TimeSpan.FromMilliseconds(1000))

        Dim coord As GeoCoordinate = watcher.Position.Location

        If coord.IsUnknown <> True Then
            Console.WriteLine("Lat: {0}, Long: {1}", coord.Latitude, coord.Longitude)
        Else
            Console.WriteLine("Unknown latitude and longitude.")
        End If
    End Sub

    Public Sub Main()
        GetLocationProperty()
        Console.ReadLine()
    End Sub

End Module

Das folgende Programm zeigt, wie Sie fortlaufende Standortupdates erhalten, indem Sie Ereignisse abonnieren PositionChanged .

using System;
using System.Device.Location;

namespace GetLocationEvent
{
    class AsyncProgram
    {
        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);
            }
        }
    }
}

Imports System.Device.Location

Module GetLocationEvent
    Public Class CLocation
        Private WithEvents watcher As GeoCoordinateWatcher
        Public Sub GetLocationEvent()
            watcher = New System.Device.Location.GeoCoordinateWatcher()
            AddHandler watcher.PositionChanged, AddressOf watcher_PositionChanged
            Dim started As Boolean = watcher.TryStart(False, TimeSpan.FromMilliseconds(1000))

            If Not started Then
                Console.WriteLine("GeoCoordinateWatcher timed out on start.")
            End If
        End Sub

        Private Sub watcher_PositionChanged(ByVal sender As Object, ByVal e As GeoPositionChangedEventArgs(Of GeoCoordinate))
            PrintPosition(e.Position.Location.Latitude, e.Position.Location.Longitude)
        End Sub

        Private Sub PrintPosition(ByVal Latitude As Double, ByVal Longitude As Double)
            Console.WriteLine("Latitude: {0}, Longitude {1}", Latitude, Longitude)
        End Sub
    End Class


    Public Sub Main()
        Dim myLocation As New CLocation()
        myLocation.GetLocationEvent()
        Console.WriteLine("Enter any key to quit.")
        Console.ReadLine()
    End Sub

End Module

Hinweise

Die GeoCoordinateWatcher -Klasse stellt koordinatenbasierte Standortdaten vom aktuellen Standortanbieter bereit. Der aktuelle Standortanbieter wird basierend auf einer Reihe von Faktoren als der höchste auf dem Computer priorisiert, z. B. das Alter und die Genauigkeit der Daten aller Anbieter, die von Standortanwendungen angeforderte Genauigkeit sowie die Energieverbrauchs- und Leistungsbeeinträchtigungen, die mit dem Standortanbieter verbunden sind. Der aktuelle Standortanbieter kann sich im Laufe der Zeit ändern, instance, wenn ein GPS-Gerät sein Satellitensignal im Innenbereich verliert und ein Wi-Fi Triangulationsanbieter zum genauesten Anbieter auf dem Computer wird.

Um mit dem Zugriff auf Standortdaten zu beginnen, erstellen Sie ein GeoCoordinateWatcher , und rufen Sie Start auf, oder TryStart um die Erfassung von Daten vom aktuellen Standortanbieter zu initiieren.

Die Status -Eigenschaft kann überprüft werden, um festzustellen, ob Daten verfügbar sind. Wenn Daten verfügbar sind, können Sie den Standort einmal von der Position -Eigenschaft abrufen oder fortlaufende Standortaktualisierungen erhalten, indem Sie das PositionChanged Ereignis behandeln.

Die PermissionEigenschaften , Statusund Position unterstützen INotifyPropertyChanged, damit eine Anwendung Daten an diese Eigenschaften binden kann.

In Windows 7 sind alle System.Device.Location Klassen voll funktionsfähig, wenn ein Standortanbieter installiert ist und den Speicherort des Computers auflösen kann.

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

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

• Der durch die Location -Eigenschaft von Position angegebene Speicherort ist Unknownimmer .

• Es werden keine Standortereignisse ausgelöst.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Explizite Schnittstellenimplementierungen

Gilt für: