Freigeben über


PushNotificationChannelManager Klasse

Definition

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)]
class PushNotificationChannelManager final
/// [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)]
public static class PushNotificationChannelManager
[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

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.

Gilt für:

Weitere Informationen