BackgroundTaskBuilder.Register Método

Definição

Namespace:

Windows.ApplicationModel.Background

Sobrecargas

Register()	Registra uma tarefa em segundo plano com o sistema.
Register(String)

Register()

Registra uma tarefa em segundo plano com o sistema.

public:
 virtual BackgroundTaskRegistration ^ Register() = Register;

BackgroundTaskRegistration Register();

public BackgroundTaskRegistration Register();

function register()

Public Function Register () As BackgroundTaskRegistration

Retornos

BackgroundTaskRegistration

Uma instância de um objeto BackgroundTaskRegistration .

Exemplos

Exemplo de BackgroundTask

Comentários

A tarefa deve ter um gatilho de evento para que o método Register seja bem-sucedido. O sistema agenda a tarefa em segundo plano quando o evento de gatilho ocorre e todas as suas condições foram atendidas.

Uma tarefa em segundo plano fora do processo também deve especificar um ponto de entrada de tarefa. Consulte Criar e registrar uma tarefa em segundo plano no processo e Criar e registrar uma tarefa em segundo plano fora do processo para obter detalhes sobre como registrar cada tipo de tarefa.

Validação de parâmetro de tarefa em segundo plano

Windows 8 Windows 8 não valida os parâmetros definidos no objeto BackgroundTaskBuilder até que o sistema tente executar a tarefa em segundo plano. Se os parâmetros não forem válidos, a tarefa em segundo plano não poderá ser iniciada e uma entrada de log de eventos será criada.

Windows 8.1 Começando no Windows 8.1, os parâmetros usados para registrar a tarefa em segundo plano são validados no momento do registro. Um erro será retornado se o registro da tarefa em segundo plano falhar, permitindo que o aplicativo determine se a tarefa em segundo plano é válida ou não. Para C# e Visual Basic, erros de registro de tarefa normalmente resultam na geração de exceções específicas do .NET. Essas exceções são geradas como exceções de primeira chance e devem ser corrigidas enquanto você ainda está desenvolvendo seu código. Os aplicativos Windows 8 existentes em execução no Windows 8.1 estão sujeitos a esse novo comportamento do sistema, o que pode fazer com que o aplicativo falhe se não conseguir lidar com um registro de tarefa em segundo plano com falha. (Uma entrada de log de eventos ainda será gerada para o registro de tarefa em segundo plano com falha.) Como resultado, Windows 8 aplicativos que registram tarefas inválidas em segundo plano devem ser reescritos para registrar tarefas em segundo plano corretamente e para lidar com o registro de tarefas em segundo plano com falha como uma exceção capturada.

Register(String)

public:
 virtual BackgroundTaskRegistration ^ Register(Platform::String ^ taskName) = Register;

/// [Windows.Foundation.Metadata.Experimental]
BackgroundTaskRegistration Register(winrt::hstring const& taskName);

[Windows.Foundation.Metadata.Experimental]
public BackgroundTaskRegistration Register(string taskName);

function register(taskName)

Public Function Register (taskName As String) As BackgroundTaskRegistration

Parâmetros

taskName

String

Platform::String

winrt::hstring

Retornos

BackgroundTaskRegistration

Atributos

ExperimentalAttribute