BackgroundTransferCompletionGroup 類別

  • 參考

定義

命名空間:
Windows.Networking.BackgroundTransfer
編輯

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

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
屬性
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 已完成，而且不會再 (DownloadOperation 或 UploadOperation 物件) 新增完成群組的背景傳輸作業。

適用於

另請參閱