StorageLibraryChangeTrackerTrigger Klasse

Referenz

Definition

Namespace:: Windows.ApplicationModel.Background

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt eine Dateiänderung in einem StorageFolder dar, die eine Auszuführende Hintergrundaufgabe auslöst.

public ref class StorageLibraryChangeTrackerTrigger sealed : IBackgroundTrigger

/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.Background.IStorageLibraryChangeTrackerTriggerFactory, 393216, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class StorageLibraryChangeTrackerTrigger final : IBackgroundTrigger

[Windows.Foundation.Metadata.Activatable(typeof(Windows.ApplicationModel.Background.IStorageLibraryChangeTrackerTriggerFactory), 393216, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class StorageLibraryChangeTrackerTrigger : IBackgroundTrigger

function StorageLibraryChangeTrackerTrigger(tracker)

Public NotInheritable Class StorageLibraryChangeTrackerTrigger
Implements IBackgroundTrigger

Vererbung: Object Platform::Object IInspectable StorageLibraryChangeTrackerTrigger

Attribute: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert: IBackgroundTrigger

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v6.0)

Beispiele

Das folgende Beispiel zeigt, wie Sie einen Änderungstrigger für die Speicherbibliothek für den angegebenen Ordner erstellen und registrieren.

private async Task<bool> RegisterBackgroundTask(StorageFolder folder)
{
    StorageLibraryChangeTracker tracker = folder.TryGetChangeTracker();
    if (tracker != null)
    {
        tracker.Enable();

        StorageLibraryChangeTrackerTrigger trigger = new StorageLibraryChangeTrackerTrigger(tracker);

        string name = "StorageLibraryChangeTrackerTask"; // a friendly task name
        string taskEntryPoint = "Tasks.StorageLibraryChangeTrackerTask";

        var access = await BackgroundExecutionManager.RequestAccessAsync(); // to register background tasks, you must first call RequestAccessAsync()

        BackgroundTaskBuilder builder = new BackgroundTaskBuilder();
        builder.Name = name;
        builder.TaskEntryPoint = taskEntryPoint;
        builder.SetTrigger(trigger);
        BackgroundTaskRegistration task = builder.Register();

        return true;
    }

    // Not getting a tracker means we don't have access to the folder or it’s not a physical folder
    return false;
}

Hinweise

Die Hintergrundaufgabe muss im Manifest deklariert werden, bevor die Registrierung erfolgreich sein kann.

Konstruktoren

StorageLibraryChangeTrackerTrigger(StorageLibraryChangeTracker)

Initialisiert eine neue StorageLibraryChangeTrackerTrigger-instance.

Gilt für: