Поделиться через


BackgroundTaskBuilder.Register Метод

Определение

Перегрузки

Register()

Регистрирует фоновую задачу в системе.

Register(String)

Register()

Регистрирует фоновую задачу в системе.

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

Возвращаемое значение

Экземпляр объекта BackgroundTaskRegistration .

Примеры

Пример BackgroundTask

Комментарии

Для успешного выполнения метода Register задача должна иметь триггер события. Система планирует фоновую задачу при возникновении события триггера и выполнении всех ее условий.

Внепроцессная фоновая задача также должна указывать точку входа в задачу. Дополнительные сведения о регистрации каждого типа задач см. в разделах Создание и регистрация фоновой задачи внутри процесса и Создание и регистрация внепроцессной фоновой задачи .

Проверка параметров фоновой задачи

Windows 8 Windows 8 не проверяет параметры, заданные в объекте BackgroundTaskBuilder, пока система не попытается запустить фоновую задачу. Если параметры недопустимы, фоновая задача не может запуститься и создается запись журнала событий.

Windows 8.1 Начиная с Windows 8.1, параметры, используемые для регистрации фоновой задачи, проверяются во время регистрации. Если регистрация фоновой задачи завершается сбоем, возвращается ошибка, что позволяет приложению определить, является ли фоновая задача допустимой. Для C# и Visual Basic ошибки регистрации задач обычно приводят к возникновению определенных исключений .NET. Эти исключения создаются как исключения первой возможности и должны быть исправлены во время разработки кода. Существующие Windows 8 приложения, работающие на Windows 8.1, зависят от нового поведения системы, что может привести к сбою приложения, если оно не может обработать неудачную регистрацию фоновой задачи. (Для неудачной регистрации фоновой задачи по-прежнему будет создана запись журнала событий.) В результате Windows 8 приложения, которые регистрируют недопустимые фоновые задачи, должны быть перезаписаны для правильной регистрации фоновых задач и обработки неудачной регистрации фоновых задач как перехватываемого исключения.

Применяется к

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

Возвращаемое значение

Атрибуты

Применяется к