BackgroundTaskCompletedEventArgs 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
완료 알림이 전송될 때 작업에 대한 완료 정보를 나타냅니다.
public ref class BackgroundTaskCompletedEventArgs sealed
/// [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 BackgroundTaskCompletedEventArgs final
[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 BackgroundTaskCompletedEventArgs
Public NotInheritable Class BackgroundTaskCompletedEventArgs
- 상속
- 특성
Windows 요구 사항
디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
예제
다음 예제에서는 BackgroundTaskCompletedEventArgs 클래스를 BackgroundTaskCompletedEventHandler 대리자와 함께 사용하여 앱이 포그라운드에 있는 동안 백그라운드 작업 완료를 모니터링하는 방법을 보여줍니다. 이는 LocalSettings를 통해 상태 보고하는 백그라운드 작업에 따라 달라집니다.
private async void OnCompleted(IBackgroundTaskRegistration task,
BackgroundTaskCompletedEventArgs args)
{
var settings = ApplicationData.Current.LocalSettings;
var key = task.TaskId.ToString();
string status = settings.Values[key].ToString();
//
// UI element updates should be done asynchronously.
//
await Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
() =>
{
ExampleProgressElement.Text = "Task completed with status: " + status;
});
}
설명
시스템은 이 클래스를 생성하여 애플리케이션의 BackgroundTaskCompletedEventHandler 처리기에 인수로 전달합니다.
속성
InstanceId |
이 완료 상태 알림에 대한 백그라운드 작업 instance 식별자를 가져옵니다. |
메서드
CheckResult() |
백그라운드 작업 완료 이벤트가 오류를 보고한 경우 예외를 throw합니다. |
적용 대상
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기