Geofence 建構函式

定義

命名空間:

Windows.Devices.Geolocation.Geofencing

多載

Geofence(String, IGeoshape)	根據地理柵欄的識別碼和圖形，初始化新的Geofence物件。
Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean)	根據識別碼、地理柵欄的形狀、要監視地理柵欄的狀態，以及singleUse旗標，初始化新的Geofence物件。
Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan)	根據識別碼、地理柵欄的形狀、要監視地理柵欄的狀態、單一使用旗標和地理柵欄的dwellTime，初始化新的Geofence物件。
Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan, DateTime, TimeSpan)	根據識別碼、地理柵欄的形狀、要監視地理柵欄的狀態、單一使用旗標、地理柵欄的dwellTime、開始監視地理柵欄的時間，以及地理柵欄的持續時間，初始化新的Geofence物件。

Geofence(String, IGeoshape)

根據地理柵欄的識別碼和圖形，初始化新的Geofence物件。

public:
 Geofence(Platform::String ^ id, IGeoshape ^ geoshape);

 Geofence(winrt::hstring const& id, IGeoshape const& geoshape);

public Geofence(string id, IGeoshape geoshape);

function Geofence(id, geoshape)

Public Sub New (id As String, geoshape As IGeoshape)

參數

id

String

Platform::String

winrt::hstring

地理柵欄的識別碼。

geoshape

IGeoshape

定義要監視之地理柵欄的區域。

Windows 需求

應用程式功能

location

備註

使用此建構函式時， MonitoredStates 預設會同時監視 Entered 和 Exited 狀態， SingleUse 預設為 false， DwellTime 預設為 10 秒， StartTime 預設為 0 表示立即啟動， 而 Duration 預設為 0，這表示永久。

識別碼值必須是非 Null 且小於 64 個字元。

地理圖案參數必須是具有符合平臺的 SpatialReferenceId的非 Null Geocircle，否則會擲回例外狀況。

另請參閱

• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean)
• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan)
• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan, DateTime, TimeSpan)
• 地理柵欄，開始完成

Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean)

根據識別碼、地理柵欄的形狀、要監視地理柵欄的狀態，以及singleUse旗標，初始化新的Geofence物件。

public:
 Geofence(Platform::String ^ id, IGeoshape ^ geoshape, MonitoredGeofenceStates monitoredStates, bool singleUse);

 Geofence(winrt::hstring const& id, IGeoshape const& geoshape, MonitoredGeofenceStates const& monitoredStates, bool const& singleUse);

public Geofence(string id, IGeoshape geoshape, MonitoredGeofenceStates monitoredStates, bool singleUse);

function Geofence(id, geoshape, monitoredStates, singleUse)

Public Sub New (id As String, geoshape As IGeoshape, monitoredStates As MonitoredGeofenceStates, singleUse As Boolean)

參數

id

String

Platform::String

winrt::hstring

地理柵欄的識別碼。

geoshape

IGeoshape

定義要監視之地理柵欄的區域。

monitoredStates

MonitoredGeofenceStates

要監視地理柵欄的狀態。

singleUse

Boolean

bool

True 表示應該只監視地理柵欄以供一次使用。 False 表示應該監視地理柵欄以使用多個用途。

Windows 需求

應用程式功能

location

另請參閱

• Geofence(String, IGeoshape)
• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan)
• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan, DateTime, TimeSpan)
• 地理柵欄，開始完成

Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan)

根據識別碼、地理柵欄的形狀、要監視地理柵欄的狀態、單一使用旗標和地理柵欄的dwellTime，初始化新的Geofence物件。

public:
 Geofence(Platform::String ^ id, IGeoshape ^ geoshape, MonitoredGeofenceStates monitoredStates, bool singleUse, TimeSpan dwellTime);

 Geofence(winrt::hstring const& id, IGeoshape const& geoshape, MonitoredGeofenceStates const& monitoredStates, bool const& singleUse, TimeSpan const& dwellTime);

public Geofence(string id, IGeoshape geoshape, MonitoredGeofenceStates monitoredStates, bool singleUse, System.TimeSpan dwellTime);

function Geofence(id, geoshape, monitoredStates, singleUse, dwellTime)

Public Sub New (id As String, geoshape As IGeoshape, monitoredStates As MonitoredGeofenceStates, singleUse As Boolean, dwellTime As TimeSpan)

參數

id

String

Platform::String

winrt::hstring

地理柵欄的識別碼。

geoshape

IGeoshape

定義要監視之地理柵欄的區域。

monitoredStates

MonitoredGeofenceStates

要監視地理柵欄的狀態。

singleUse

Boolean

bool

True 表示應該只監視地理柵欄以供一次使用。 False 表示應該監視地理柵欄以使用多個用途。

dwellTime

TimeSpan TimeSpan

位置必須在地理柵欄內或離開地理柵欄的時間，才能觸發通知。 這個物件必須代表正值。

Windows 需求

應用程式功能

location

另請參閱

• Geofence(String, IGeoshape)
• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean)
• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan, DateTime, TimeSpan)
• 地理柵欄，開始完成

Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan, DateTime, TimeSpan)

根據識別碼、地理柵欄的形狀、要監視地理柵欄的狀態、單一使用旗標、地理柵欄的dwellTime、開始監視地理柵欄的時間，以及地理柵欄的持續時間，初始化新的Geofence物件。

public:
 Geofence(Platform::String ^ id, IGeoshape ^ geoshape, MonitoredGeofenceStates monitoredStates, bool singleUse, TimeSpan dwellTime, DateTime startTime, TimeSpan duration);

 Geofence(winrt::hstring const& id, IGeoshape const& geoshape, MonitoredGeofenceStates const& monitoredStates, bool const& singleUse, TimeSpan const& dwellTime, DateTime const& startTime, TimeSpan const& duration);

public Geofence(string id, IGeoshape geoshape, MonitoredGeofenceStates monitoredStates, bool singleUse, System.TimeSpan dwellTime, System.DateTimeOffset startTime, System.TimeSpan duration);

function Geofence(id, geoshape, monitoredStates, singleUse, dwellTime, startTime, duration)

Public Sub New (id As String, geoshape As IGeoshape, monitoredStates As MonitoredGeofenceStates, singleUse As Boolean, dwellTime As TimeSpan, startTime As DateTimeOffset, duration As TimeSpan)

參數

id

String

Platform::String

winrt::hstring

地理柵欄的識別碼。

geoshape

IGeoshape

定義要監視之地理柵欄的區域。

monitoredStates

MonitoredGeofenceStates

要監視地理柵欄的狀態。

singleUse

Boolean

bool

True 表示應該只監視地理柵欄以供一次使用。 False 表示應該監視地理柵欄以使用多個用途。

dwellTime

TimeSpan TimeSpan

位置必須在地理柵欄內或離開地理柵欄的時間，才能觸發通知。這個物件必須代表正值。

startTime

DateTime DateTimeOffset

開始監視地理柵欄的時間。

duration

TimeSpan TimeSpan

監視地理柵欄的時間持續時間。 持續時間從 startTime開始。 這個物件必須代表正值。

Windows 需求

應用程式功能

location

備註

您必須指定要監視地理柵欄 的 Entered 或 Exited 狀態或兩者。 無法建立只監視 已移除 狀態的地理柵欄。

識別碼值必須是非 Null 且小於 64 個字元。

地理圖案參數必須是具有符合平臺的 SpatialReferenceId的非 Null Geocircle，否則會擲回例外狀況。

如果地理柵欄的到期日-也就是開始時間加上持續時間時間範圍 - 發生于建立時間加上停留時間值之後，將會擲回例外狀況。

另請參閱

• Geofence(String, IGeoshape)
• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean)
• Geofence(String, IGeoshape, MonitoredGeofenceStates, Boolean, TimeSpan)
• 地理柵欄，開始完成