PushNotificationChannelManager 类

定义

命名空间:

Windows.Networking.PushNotifications

创建用于从 Windows 推送通知服务 (WNS) 检索推送通知通道的对象。 这些通道绑定到应用或 辅助磁贴。

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

继承

Object Platform::Object IInspectable PushNotificationChannelManager

属性

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
应用功能	internetClient

示例

以下示例演示如何使用 CreatePushNotificationChannelForApplicationAsync 方法检索调用应用的推送通知通道。

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

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

以下示例演示如何使用 CreatePushNotificationChannelForSecondaryTileAsync 方法检索辅助磁贴的推送通知通道。

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

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

注解

版本历史记录

Windows 版本	SDK 版本	增值
1607	14393	GetForUser
1703	15063	GetDefault
2004	19041	ChannelsRevoked

方法

CreatePushNotificationChannelForApplicationAsync()	创建绑定到调用应用的 对象，通过该对象从 Windows 推送通知服务 (WNS) 检索推送通知通道。
CreatePushNotificationChannelForApplicationAsync(String)	创建绑定到指定应用的 对象，通过该对象从 Windows 推送通知服务 (WNS) 检索推送通知通道。 指定的应用必须与调用应用位于同一个包中。 此重载应仅从多应用包调用，大多数应用应使用不带参数的 方法。
CreatePushNotificationChannelForSecondaryTileAsync(String)	创建绑定到 辅助磁贴的对象，通过该对象从 Windows 推送通知服务 (WNS) 检索推送通知通道。 磁贴可以是调用应用的辅助磁贴，也可以是同一包中任何其他应用的辅助磁贴。
GetDefault()	获取活动用户的管理器。
GetForUser(User)	获取指定用户的推送通知。

事件

ChannelsRevoked

撤销推送通道时引发，以便可以立即请求新通道。 这可以最大程度地减少因使用已撤销的 WNS 通道而导致的任何停机时间。 事件参数类型为 PushNotificationChannelsRevokedEventArgs。

另请参阅

• PushNotificationChannel
• Windows 推送通知服务 (WNS) 概述
• 推送和定期通知示例 (存档)
• 快速入门：发送推送通知
• 如何请求、创建和保存通知通道
• 推送通知服务请求和响应头