WebUIBackgroundTaskInstance.Current 속성

정의

네임스페이스:

Windows.UI.WebUI

현재 백그라운드 작업을 가져옵니다.

public:
 static property IWebUIBackgroundTaskInstance ^ Current { IWebUIBackgroundTaskInstance ^ get(); };

static IWebUIBackgroundTaskInstance Current();

public static IWebUIBackgroundTaskInstance Current { get; }

var iWebUIBackgroundTaskInstance = WebUIBackgroundTaskInstance.current;

Public Shared ReadOnly Property Current As IWebUIBackgroundTaskInstance

속성 값

IWebUIBackgroundTaskInstance

현재 백그라운드 작업입니다. 이 속성은 백그라운드 작업의 컨텍스트에서만 액세스할 수 있습니다. 이 속성은 포그라운드 앱에서 null입니다.

설명

앱은 BackgroundTaskBuilder 클래스를 사용하여 백그라운드 작업을 만듭니다. SetTrigger 메서드는 태스크에 대한 이벤트 트리거로 설정해야 합니다. TaskEntryPoint는 실행할 코드를 포함하는 JavaScript 파일을 지정해야 합니다. 그런 다음, 앱은 Register 메서드를 호출하여 백그라운드 작업을 등록 합니다. 트리거가 실행되면 시스템은 JavaScript 파일에서 코드를 실행합니다.

또한 앱은 앱 매니페스트의 섹션에서 JavaScript 파일을 <Extensions> 지정해야 합니다. 예: <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">.

백그라운드 작업이 실행되면 Current 속성에서 반환된 개체를 사용하여 백그라운드 작업의 성공 또는 실패를 설정하고 작업의 속성에 액세스할 수 있습니다.

백그라운드 작업이 작업을 완료한 후 작업은 웹 작업자 닫기 메서드를 호출하여 자체 작업을 종료해야 합니다. 이렇게 하면 사용자의 메모리와 배터리를 계속 사용하지 않습니다. 또한 동일한 트리거에 대한 하나의 백그라운드 작업만 한 번에 실행할 수 있으므로 새 작업을 트리거하기 전에 이전 작업을 닫아야 합니다.

참고

백그라운드 작업은 수명이 짧은 작업입니다. 일반적으로 백그라운드 작업에서 이벤트 콜백에 등록해서는 안 됩니다. Windows 런타임 이벤트에 등록하고 앱의 포그라운드 instance 해당 이벤트에 등록하는 경우 백그라운드 작업의 콜백이 신뢰할 수 없을 수 있습니다.