GeofenceMonitor GeofenceMonitor GeofenceMonitor GeofenceMonitor Class

Gets the GeofenceMonitor object which contains all of an app's Geofence information.

public : static GeofenceMonitor Current { get; }public static GeofenceMonitor Current { get; }Public Static ReadOnly Property Current As GeofenceMonitor// You can use this property in JavaScript.

Returns a vector of the app's Geofence objects currently registered with the system-wide GeofenceMonitor.

public : IVector<Geofence> Geofences { get; }public IList<Geofence> Geofences { get; }Public ReadOnly Property Geofences As IList<Geofence>// You can use this property in JavaScript.

Remarks

Register a Geofence to be monitored by the system by adding it to this collection.

Geofences are persisted to disk, so they only need to be added to the system once. Attempting to add a Geofence with an Id that is already registered will throw an exception.

Attempting to remove a Geofence from the Geofences property will fail with an exception if the specified Geofence is registered with the system but does not belong to the calling application's collection.

This vector reflects only updates made by the app. To view changes made by the system, as in after a single-use Geofence is triggered and removed, the app can call this property again or safely remove the removed Geofence from a previously returned vector.

Last reading of the device's location.

public : Geoposition LastKnownGeoposition { get; }public Geoposition LastKnownGeoposition { get; }Public ReadOnly Property LastKnownGeoposition As Geoposition// You can use this property in JavaScript.

Remarks

Before using the value from this property, the application must first check that the value is not NULL.

Indicates the current state of the GeofenceMonitor.

public : GeofenceMonitorStatus Status { get; }public GeofenceMonitorStatus Status { get; }Public ReadOnly Property Status As GeofenceMonitorStatus// You can use this property in JavaScript.

Gets a collection of status changes to the Geofence objects in the Geofences collection of the GeofenceMonitor.

public : IVectorView<GeofenceStateChangeReport> ReadReports()public IReadOnlyList<GeofenceStateChangeReport> ReadReports()Public Function ReadReports() As IReadOnlyList( Of GeofenceStateChangeReport )// You can use this method in JavaScript.

Remarks

Each report in the collection contains the most recent state for the geofences that changed state since the last time ReadReports was called. Older state changes may be present in the collection if ReadReports hasn't been called over a period of time when many geofence state changes have occurred, but the system may purge these older state changes.

The collection returned from this method may be empty and contain no GeofenceStateChangeReport objects. This can happen if no status changes have occurred since the last time the method was called, either by the app or the background task.

Raised when the state of one or more Geofence objects in the Geofences collection of the GeofenceMonitor has changed

public : event TypedEventHandler GeofenceStateChanged<GeofenceMonitor,  object>public event TypedEventHandler GeofenceStateChanged<GeofenceMonitor,  object>Public Event GeofenceStateChanged<GeofenceMonitor,  object>// You can use this event in JavaScript.

Remarks

This event is raised when your app is running and the state of a geofence registered by your app changes. This event is also raised when your app activates if there are unread reports in the collection obtained by calling ReadReports. This allows an app that is coming back from being suspended to be notified that there are unread reports in the queue and update the UI accordingly. This also allows your app to read reports that occurred in the background in cases where your background task was not launched to due to conditions set with SystemCondition, such as waiting for an internet connection or waiting for the user to be present.

Raised when the status of the GeofenceMonitor has changed.

public : event TypedEventHandler StatusChanged<GeofenceMonitor,  object>public event TypedEventHandler StatusChanged<GeofenceMonitor,  object>Public Event StatusChanged<GeofenceMonitor,  object>// You can use this event in JavaScript.

Remarks

When using a geofence, use the GeofenceMonitor 's StatusChanged event to monitor changes in location permissions instead of the StatusChanged event from the Geolocator class. A GeofenceMonitorStatus of Disabled is equivalent to a **Disabled **PositionStatus - both indicate that the app does not have permission to access the location.