BackgroundTaskRegistration Class

Stellt einen Hintergrundtask dar, der beim System registriert wurde.

Syntax


var backgroundTaskRegistration = Windows.ApplicationModel.Background.BackgroundTaskRegistration;

Attribute

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Member

BackgroundTaskRegistrationKlasse hat diese Membertypen:

Ereignisse

BackgroundTaskRegistrationKlasse hat diese Ereignisse.

EreignisBeschreibung
Completed Attaches a completed event handler to the registered background task.
Progress Attaches a progress event handler to the registered background task.

 

Methoden

The BackgroundTaskRegistration Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
Unregister Cancels the registration of a registered background task.

 

Eigenschaften

Der BackgroundTaskRegistrationKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

AllTasks

SchreibgeschütztEnumerates an application's registered background tasks.

Name

SchreibgeschütztGets the name of a registered background task.

TaskId

SchreibgeschütztGets the identifier of a registered background task.

 

Hinweise

Das System gibt eine Instanz dieser Klasse zurück, wenn die Anwendung die BackgroundTaskBuilder.Register-Methode aufruft.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die AllTasks- Eigenschaft der BackgroundTaskRegistration-Klasse verwendet wird, um das vorhandene Hintergrundtask-Registrierungsobjekt für den Hintergrundtask der App abzurufen (wenn der Task derzeit registriert ist).


//
// The name of the background task for your app.
//
string name = "ExampleTaskName";

//
// Get a list of all background tasks. The list is returned as
// a dictionary of IBackgroundTaskRegistration objects.
//
foreach (var cur in BackgroundTaskRegistration.AllTasks)
{
if (cur.Value.Name == name)
    {
        //
        // Take some action based on finding the background task.

        //
        // For example, unregister the task:
        //
        // cur.Value.Unregister(true);

        // 
        // Or, set a global variable indicating that the task is
        // already registered:
        //
        // TaskAlreadyRegistered = true;
    }
}

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Metadaten

Windows.winmd

 

 

Anzeigen:
© 2015 Microsoft