Een lokale app-melding verzenden vanuit een C#-app

Voeg eerst in uw Package.appxmanifesthet volgende toe:

1. Declaratie voor xmlns:com
2. Declaratie voor xmlns:desktop
3. In het kenmerk IgnorableNamespaces , com en desktop
4. desktop:Extension voor windows.toastNotificationActivation om de CLSID van uw toast-activator te declareren (met behulp van een nieuwe GUID van uw keuze).
5. Alleen MSIX: com:Extension voor de COM-activator met behulp van de GUID uit stap 4. Zorg ervoor dat u de Arguments="-ToastActivated" opneemt, zodat u weet dat uw lancering afkomstig is van een melding

Package.appxmanifest

<!--Add these namespaces-->
<Package
  ...
  xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="... com desktop">
  ...
  <Applications>
    <Application>
      ...
      <Extensions>

        <!--Specify which CLSID to activate when toast clicked-->
        <desktop:Extension Category="windows.toastNotificationActivation">
          <desktop:ToastNotificationActivation ToastActivatorCLSID="replaced-with-your-guid-C173E6ADF0C3" /> 
        </desktop:Extension>

        <!--Register COM CLSID LocalServer32 registry key-->
        <com:Extension Category="windows.comServer">
          <com:ComServer>
            <com:ExeServer Executable="YourProject\YourProject.exe" Arguments="-ToastActivated" DisplayName="Toast activator">
              <com:Class Id="replaced-with-your-guid-C173E6ADF0C3" DisplayName="Toast activator"/>
            </com:ExeServer>
          </com:ComServer>
        </com:Extension>

      </Extensions>
    </Application>
  </Applications>
 </Package>

Vervolgens, in de opstartcode van uw app (App.xaml.cs OnStartup voor WPF), abonneer u op de OnActivated-gebeurtenis.

// Listen to notification activation
ToastNotificationManagerCompat.OnActivated += toastArgs =>
{
    // Obtain the arguments from the notification
    ToastArguments args = ToastArguments.Parse(toastArgs.Argument);

    // Obtain any user input (text boxes, menu selections) from the notification
    ValueSet userInput = toastArgs.UserInput;

    // Need to dispatch to UI thread if performing UI operations
    Application.Current.Dispatcher.Invoke(delegate
    {
        // TODO: Show the corresponding content
        MessageBox.Show("Toast activated. Args: " + toastArgs.Argument);
    });
};

Wanneer de gebruiker op een van uw meldingen klikt (of een knop in de melding), gebeurt het volgende...

Als uw app momenteel wordt uitgevoerd...

1. De ToastNotificationManagerCompat.OnActivated gebeurtenis wordt aangeroepen in een achtergrondthread.

Als uw app momenteel is gesloten...

1. De EXE van uw app wordt gestart en ToastNotificationManagerCompat.WasCurrentProcessToastActivated() retourneert true om aan te geven dat het proces is gestart vanwege een moderne activering en dat de event handler binnenkort zal worden aangeroepen.
2. Vervolgens wordt de gebeurtenis ToastNotificationManagerCompat.OnActivated aangeroepen op een achtergrondthread.

Wanneer de gebruiker op een van uw meldingen klikt (of een knop in de melding), gebeurt het volgende...

Als uw app momenteel wordt uitgevoerd...

1. De ToastNotificationManagerCompat.OnActivated gebeurtenis wordt aangeroepen in een achtergrondthread.

Als uw app momenteel is gesloten...

1. De EXE van uw app wordt gestart en ToastNotificationManagerCompat.WasCurrentProcessToastActivated() retourneert true om aan te geven dat het proces is gestart vanwege een moderne activering en dat de event handler binnenkort zal worden aangeroepen.
2. Vervolgens wordt de gebeurtenis ToastNotificationManagerCompat.OnActivated aangeroepen op een achtergrondthread.

Abonneer u op de gebeurtenis OnActivated in de opstartcode van uw app (App.xaml.cs OnStartup voor WPF).

// Listen to notification activation
ToastNotificationManagerCompat.OnActivated += toastArgs =>
{
    // Obtain the arguments from the notification
    ToastArguments args = ToastArguments.Parse(toastArgs.Argument);

    // Obtain any user input (text boxes, menu selections) from the notification
    ValueSet userInput = toastArgs.UserInput;

    // Need to dispatch to UI thread if performing UI operations
    Application.Current.Dispatcher.Invoke(delegate
    {
        // TODO: Show the corresponding content
        MessageBox.Show("Toast activated. Args: " + toastArgs.Argument);
    });
};

Wanneer de gebruiker op uw melding klikt (of een knop op de melding met activering op de voorgrond), wordt de App.xaml.csOnActivated van uw app aangeroepen en worden de argumenten geretourneerd die u hebt toegevoegd.

App.xaml.cs

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle notification activation
    if (e is ToastNotificationActivatedEventArgs toastActivationArgs)
    {
        // Obtain the arguments from the notification
        ToastArguments args = ToastArguments.Parse(toastActivationArgs.Argument);

        // Obtain any user input (text boxes, menu selections) from the notification
        ValueSet userInput = toastActivationArgs.UserInput;
 
        // TODO: Show the corresponding content
    }
}

Je hoeft niets te doen. Wanneer MSIX-apps worden verwijderd, worden alle meldingen en andere gerelateerde resources automatisch opgeschoond.

Als uw app een verwijderingsfunctie heeft, moet u in uw verwijderingsfunctie ToastNotificationManagerCompat.Uninstall();aanroepen. Als uw app een 'draagbare app' zonder installatieprogramma is, kunt u overwegen deze methode aan te roepen bij het afsluiten van de app, tenzij u meldingen hebt die moeten worden bewaard nadat uw app is gesloten.

Met de verwijderingsmethode worden alle geplande en huidige meldingen opgeschoond, alle bijbehorende registerwaarden verwijderd en worden alle gekoppelde tijdelijke bestanden verwijderd die door de bibliotheek zijn gemaakt.

Je hoeft niets te doen. Wanneer UWP-apps worden verwijderd, worden alle meldingen en andere gerelateerde resources automatisch opgeschoond.

Voor bureaubladtoepassingen worden achtergrondactiveringen op dezelfde wijze behandeld als voorgrondactivering (uw OnActivated gebeurtenis-handler wordt geactiveerd). U kunt ervoor kiezen om geen gebruikersinterface weer te geven en uw app te sluiten na het afhandelen van de activering.

Wanneer u achtergrondactivering opgeeft in uw app-melding (of op een knop in de melding), wordt uw achtergrondtaak uitgevoerd in plaats van de voorgrond-app te activeren.

Zie Uw app ondersteunen met achtergrondtakenvoor meer informatie over achtergrondtaken.

Als u gericht bent op build 14393 of hoger, kunt u achtergrondtaken in proces gebruiken, waardoor dingen aanzienlijk worden vereenvoudigd. Houd er rekening mee dat in-process achtergrondtaken niet kunnen worden uitgevoerd in oudere versies van Windows. We zullen een in-process achtergrondtaak gebruiken in dit codevoorbeeld.

const string taskName = "ToastBackgroundTask";

// If background task is already registered, do nothing
if (BackgroundTaskRegistration.AllTasks.Any(i => i.Value.Name.Equals(taskName)))
    return;

// Otherwise request access
BackgroundAccessStatus status = await BackgroundExecutionManager.RequestAccessAsync();

// Create the background task
BackgroundTaskBuilder builder = new BackgroundTaskBuilder()
{
    Name = taskName
};

// Assign the toast action trigger
builder.SetTrigger(new ToastNotificationActionTrigger());

// And register the task
BackgroundTaskRegistration registration = builder.Register();

Overschrijf vervolgens in uw App.xaml.cs de methode OnBackgroundActivated. Vervolgens kunt u de vooraf gedefinieerde argumenten en gebruikersinvoer ophalen, vergelijkbaar met de activering op de voorgrond.

App.xaml.cs

protected override async void OnBackgroundActivated(BackgroundActivatedEventArgs args)
{
    var deferral = args.TaskInstance.GetDeferral();
 
    switch (args.TaskInstance.Task.Name)
    {
        case "ToastBackgroundTask":
            var details = args.TaskInstance.TriggerDetails as ToastNotificationActionTriggerDetail;
            if (details != null)
            {
                ToastArguments arguments = ToastArguments.Parse(details.Argument);
                var userInput = details.UserInput;

                // Perform tasks
            }
            break;
    }
 
    deferral.Complete();
}