Share via

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 를 실행하도록 구현해야 합니다. IBackgroundTask는 BackgroundTaskBuilder 클래스를 사용하여 등록해야 합니다. BackgroundTransferCompletionGroup.Trigger를 사용하여 작업을 설정하는 경우 Broker 인프라는 트리거되는 즉시 자동으로 등록을 취소하므로 명시적 작업 등록 취소 코드가 필요하지 않습니다.

백그라운드 작업은 앱 매니페스트에서 선언해야 합니다. 앱은 BackgroundTransferCompletionGroup을 사용하기 위해 잠금 화면 액세스가 필요하지 않습니다.

생성자

BackgroundTransferCompletionGroup()

새 BackgroundTransferCompletionGroup 개체를 만듭니다.

속성

IsEnabled

BackgroundTransferCompletionGroup에서 Enable 메서드가 이미 호출되었는지를 나타내는 값을 가져옵니다.
Trigger

BackgroundTransferCompletionGroup과 연결된 백그라운드 작업을 설정하는 데 사용되는 IBackgroundTrigger를 가져옵니다.

메서드

Enable()

BackgroundTransferCompletionGroup이 완료되었으며 더 이상 백그라운드 전송 작업(DownloadOperation 또는 UploadOperation 개체)이 완료 그룹에 추가되지 않음을 나타냅니다.

적용 대상

추가 정보