PushNotificationChannelManager Klasse

Definition

Namespace:

Windows.Networking.PushNotifications

Erstellt Objekte, die Sie zum Abrufen von Pushbenachrichtigungskanälen aus windows Push Notification Services (WNS) verwenden. Diese Kanäle sind an eine App oder sekundäre Kachel gebunden.

public ref class PushNotificationChannelManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PushNotificationChannelManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class PushNotificationChannelManager

Public Class PushNotificationChannelManager

Vererbung

Object Platform::Object IInspectable PushNotificationChannelManager

Attribute

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	internetClient

Beispiele

Das folgende Beispiel zeigt die Verwendung der CreatePushNotificationChannelForApplicationAsync-Methode zum Abrufen eines Pushbenachrichtigungskanals für die aufrufende App.

var pushNotifications = Windows.Networking.PushNotifications;
var channel;

function openNotificationsChannel() {
    var channelOperation = pushNotifications.PushNotificationChannelManager.createPushNotificationChannelForApplicationAsync();
    return channelOperation.then(function (newChannel) {
        channel = newChannel;
    }
);

Das folgende Beispiel zeigt die Verwendung der CreatePushNotificationChannelForSecondaryTileAsync-Methode zum Abrufen eines Pushbenachrichtigungskanals für eine sekundäre Kachel.

var pushNotifications = Windows.Networking.PushNotifications;
var channel;

pushNotifications.PushNotificationChannelManager.createPushNotificationChannelForSecondaryTileAsync(myTileId).then(function (channel) {
    // Your code here.
})

Hinweise

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	GetForUser
1703	15063	GetDefault
2004	19041	KanäleRevoked

Methoden

CreatePushNotificationChannelForApplicationAsync()	Erstellt ein an die aufrufende App gebundenes Objekt, über das Sie einen Pushbenachrichtigungskanal von Windows Push Notification Services (WNS) abrufen.
CreatePushNotificationChannelForApplicationAsync(String)	Erstellt ein an eine angegebene App gebundenes Objekt, über das Sie einen Pushbenachrichtigungskanal von Windows Push Notification Services (WNS) abrufen. Die angegebene App muss sich im selben Paket wie die aufrufende App befinden. Diese Überladung sollte nur aus einem Paket mit mehreren Apps aufgerufen werden. Die meisten Apps sollten die -Methode ohne Parameter verwenden.
CreatePushNotificationChannelForSecondaryTileAsync(String)	Erstellt ein an eine sekundäre Kachel gebundenes Objekt, über das Sie einen Pushbenachrichtigungskanal von Windows Push Notification Services (WNS) abrufen. Die Kachel kann eine sekundäre Kachel der aufrufenden App oder eine andere App im selben Paket sein.
GetDefault()	Ruft den Manager für den aktiven Benutzer ab.
GetForUser(User)	Ruft die Pushbenachrichtigungen für den angegebenen Benutzer ab.

Ereignisse

ChannelsRevoked

Wird ausgelöst, wenn Ihr Pushkanal widerrufen wird, sodass Sie sofort einen neuen Kanal anfordern können. Dadurch werden Ausfallzeiten minimiert, die sich aus der Verwendung eines widerrufenen WNS-Kanals ergeben. Der Ereignisargumenttyp ist PushNotificationChannelsRevokedEventArgs.

Weitere Informationen

• PushNotificationChannel
• Übersicht über die Windows-Pushbenachrichtigungsdienste (Windows Push Notification Services, WNS)
• Beispiel für Push- und regelmäßige Benachrichtigungen (archiviert)
• Schnellstart: Senden einer Pushbenachrichtigung
• So wird's gemacht: Anfordern, Erstellen und Speichern eines Benachrichtigungskanals
• Anforderungs- und Antwortheader des Pushbenachrichtigungsdiensts