Compartir a través de


BackgroundTaskBuilder.Register Método

Definición

Sobrecargas

Register()

Registra una tarea en segundo plano con el sistema.

Register(String)

Register()

Registra una tarea en segundo plano con el sistema.

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

Devoluciones

Instancia de un objeto BackgroundTaskRegistration .

Ejemplos

Ejemplo backgroundTask

Comentarios

La tarea debe tener un desencadenador de eventos para que el método Register se realice correctamente. El sistema programa la tarea en segundo plano cuando se produce su evento de desencadenador y se cumplen todas sus condiciones.

Una tarea en segundo plano fuera de proceso también debe especificar un punto de entrada de tarea. Consulte Crear y registrar una tarea en segundo plano en proceso y Crear y registrar una tarea en segundo plano fuera de proceso para obtener más información sobre cómo registrar cada tipo de tarea.

Validación de parámetros de tarea en segundo plano

Windows 8 Windows 8 no valida los parámetros establecidos en el objeto BackgroundTaskBuilder hasta que el sistema intente ejecutar la tarea en segundo plano. Si los parámetros no son válidos, la tarea en segundo plano no se puede iniciar y se crea una entrada del registro de eventos.

Windows 8.1 a partir de Windows 8.1, los parámetros usados para registrar la tarea en segundo plano se validan en el momento del registro. Se devuelve un error si se produce un error en el registro de tareas en segundo plano, lo que permite a la aplicación determinar si la tarea en segundo plano es válida o no. En el caso de C# y Visual Basic, los errores de registro de tareas suelen producir excepciones específicas de .NET. Estas excepciones se inician como excepciones de primera oportunidad y se deben corregir mientras sigue desarrollando el código. Las aplicaciones de Windows 8 existentes que se ejecutan en Windows 8.1 están sujetas a este nuevo comportamiento del sistema, lo que puede hacer que la aplicación se bloquee si no puede controlar un registro de tareas en segundo plano con errores. (Todavía se generará una entrada del registro de eventos para el registro de tareas en segundo plano con errores). Como resultado, Windows 8 aplicaciones que registren tareas en segundo plano no válidas se deben volver a escribir para registrar correctamente las tareas en segundo plano y para controlar el registro de tareas en segundo plano con errores como una excepción detectada.

Se aplica a

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

Parámetros

taskName
String

Platform::String

winrt::hstring

Devoluciones

Atributos

Se aplica a