GeoCoordinateWatcher Classe

Definição

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

Herança

Object

GeoCoordinateWatcher

Atributos

SecurityCriticalAttribute

Implementações

INotifyPropertyChanged IGeoPositionWatcher<GeoCoordinate> IDisposable

Exemplos

O programa seguinte mostra como criar e GeoCoordinateWatcher começar a adquirir dados usando um timeout de inicialização. O código imprime então as coordenadas do local, se conhecidas.

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)
            {
                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

O programa seguinte mostra como receber atualizações contínuas de localização subscrevendo eventos 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

Observações

A GeoCoordinateWatcher classe fornece dados de localização baseados em coordenadas do fornecedor de localização atual. O fornecedor de localização atual é priorizado como o mais alto no computador, com base em vários fatores, como a idade e precisão dos dados de todos os fornecedores, a precisão solicitada pelas aplicações de localização e o consumo de energia e impacto no desempenho associados ao fornecedor de localização. O fornecedor de localização atual pode mudar ao longo do tempo, por exemplo, quando um dispositivo GPS perde o sinal de satélite em interiores e um fornecedor de triangulação Wi-Fi se torna o fornecedor mais preciso no computador.

Para começar a aceder aos dados de localização, crie uma GeoCoordinateWatcher chamada Start e ou TryStart inicie a aquisição de dados junto do fornecedor de localização atual.

A Status propriedade pode ser verificada para determinar se há dados disponíveis. Se houver dados disponíveis, pode obter a localização uma única vez da Position propriedade, ou receber atualizações contínuas da localização ao tratar do PositionChanged evento.

As Permissionpropriedades , Status, e Position suportam INotifyPropertyChanged, de modo que uma aplicação pode ligar dados a estas propriedades.

Em Windows 7, todas as classes System.Device.Location estão totalmente funcionais se um fornecedor de localização estiver instalado e conseguir resolver a localização do computador.

Nota Nas versões de Windows anteriores à Windows 7, aplicam-se as seguintes condições:

• Todos System.Device.Location os objetos que têm construtores podem ser criados, mas a Status propriedade terá sempre o valor Disabled.

• A localização indicada pela Location propriedade de Position será Unknownsempre .

• Não serão levantados eventos de localização.