다음을 통해 공유


BackgroundTaskBuilder.Register 메서드

정의

오버로드

Register()

백그라운드 작업을 시스템에 등록합니다.

Register(String)

Register()

백그라운드 작업을 시스템에 등록합니다.

public:
 virtual BackgroundTaskRegistration ^ Register() = Register;
BackgroundTaskRegistration Register();
public BackgroundTaskRegistration Register();
function register()
Public Function Register () As BackgroundTaskRegistration

반환

BackgroundTaskRegistration 개체의 instance.

예제

BackgroundTask 샘플

설명

작업에 Register 메서드가 성공하려면 이벤트 트리거가 있어야 합니다. 시스템은 트리거 이벤트가 발생하고 모든 조건이 충족될 때 백그라운드 작업을 예약합니다.

Out-of-process 백그라운드 작업도 작업 진입점을 지정해야 합니다. 각 종류의 작업을 등록하는 방법에 대한 자세한 내용은 In-Process 백그라운드 작업 만들기및 등록 및 Out-of-Process 백그라운드 작업 만들기 및 등록 을 참조하세요.

백그라운드 작업 매개 변수 유효성 검사

Windows 8 Windows 8 시스템이 백그라운드 작업을 실행하려고 할 때까지 BackgroundTaskBuilder 개체에 설정된 매개 변수의 유효성을 검사하지 않습니다. 매개 변수가 유효하지 않으면 백그라운드 작업을 시작할 수 없으며 이벤트 로그 항목이 만들어집니다.

Windows 8.1 Windows 8.1 시작해서 백그라운드 작업을 등록하는 데 사용되는 매개 변수는 등록 시 유효성이 검사됩니다. 백그라운드 작업 등록이 실패하면 오류가 반환되므로 앱에서 백그라운드 작업이 유효한지 여부를 확인할 수 있습니다. C# 및 Visual Basic의 경우 작업 등록 오류로 인해 일반적으로 특정 .NET 예외가 throw됩니다. 이러한 예외는 첫 번째 예외로 throw되며 코드를 개발하는 동안 수정해야 합니다. Windows 8.1 실행되는 기존 Windows 8 앱에는 이 새로운 시스템 동작이 적용되므로 실패한 백그라운드 작업 등록을 처리할 수 없는 경우 앱이 충돌할 수 있습니다. (실패한 백그라운드 작업 등록에 대해 이벤트 로그 항목이 계속 생성됩니다.) 따라서 잘못된 백그라운드 작업을 등록하는 Windows 8 앱을 다시 작성하여 백그라운드 작업을 올바르게 등록하고 실패한 백그라운드 작업 등록을 catch된 예외로 처리해야 합니다.

적용 대상

Register(String)

public:
 virtual BackgroundTaskRegistration ^ Register(Platform::String ^ taskName) = Register;
/// [Windows.Foundation.Metadata.Experimental]
BackgroundTaskRegistration Register(winrt::hstring const& taskName);
BackgroundTaskRegistration Register(winrt::hstring const& taskName);
[Windows.Foundation.Metadata.Experimental]
public BackgroundTaskRegistration Register(string taskName);
public BackgroundTaskRegistration Register(string taskName);
function register(taskName)
Public Function Register (taskName As String) As BackgroundTaskRegistration

매개 변수

taskName
String

Platform::String

winrt::hstring

반환

특성

적용 대상