共用方式為


BackgroundTransferCompletionGroup 類別

定義

代表一組背景傳輸作業, (DownloadOperationUploadOperation 物件) 一旦完成所有作業, (作業) 順利完成或發生錯誤時觸發背景工作。

public ref class BackgroundTransferCompletionGroup sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackgroundTransferCompletionGroup final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BackgroundTransferCompletionGroup final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BackgroundTransferCompletionGroup
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BackgroundTransferCompletionGroup
function BackgroundTransferCompletionGroup()
Public NotInheritable Class BackgroundTransferCompletionGroup
繼承
Object Platform::Object IInspectable BackgroundTransferCompletionGroup
屬性

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

BackgroundTransferCompletionGroup 類別可讓應用程式註冊,在背景傳輸作業完成之後立即接收通知,即使應用程式不在前景也一樣。 應用程式會註冊背景工作,以接收在背景傳輸順利完成或發生錯誤時所發生的通知。 這可讓應用程式在完成時立即收到通知,而不是要求應用程式在下次重新開機或移至前景時等候,以查詢完成。

應用程式必須實作 IBackgroundTask ,才能執行以接收完成通知。 必須使用BackgroundTaskBuilder類別來註冊IBackgroundTask。 當 BackgroundTransferCompletionGroup.Trigger 用來設定工作時,Broker 基礎結構會在觸發時自動取消註冊,因此不需要有任何明確的工作取消註冊程式碼。

背景工作必須在應用程式資訊清單中宣告。 應用程式不需要鎖定畫面存取權,才能使用 BackgroundTransferCompletionGroup。

建構函式

BackgroundTransferCompletionGroup()

建立新的 BackgroundTransferCompletionGroup 物件。

屬性

IsEnabled

取得值,這個值表示是否已呼叫BackgroundTransferCompletionGroup上的Enable方法。

Trigger

取得 IBackgroundTrigger ,用來設定與 BackgroundTransferCompletionGroup相關聯的背景工作。

方法

Enable()

指出 BackgroundTransferCompletionGroup 已完成,而且不會再 (DownloadOperationUploadOperation 物件) 新增完成群組的背景傳輸作業。

適用於

另請參閱