PushNotificationChannelManager Classe

Definizione

Spazio dei nomi:

Windows.Networking.PushNotifications

Crea oggetti usati per recuperare i canali di notifica push da Windows Push Notification Services (WNS). Questi canali sono associati a un'app o a un riquadro secondario.

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

Ereditarietà

Object Platform::Object IInspectable PushNotificationChannelManager

Attributi

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	internetClient

Esempio

Nell'esempio seguente viene illustrato l'uso del metodo CreatePushNotificationChannelForApplicationAsync per recuperare un canale di notifica push per l'app chiamante.

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

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

Nell'esempio seguente viene illustrato l'uso del metodo CreatePushNotificationChannelForSecondaryTileAsync per recuperare un canale di notifica push per un riquadro secondario.

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

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

Commenti

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	GetForUser
1703	15063	GetDefault
2004	19041	ChannelsRevoked

Metodi

CreatePushNotificationChannelForApplicationAsync()	Crea un oggetto, associato all'app chiamante, tramite cui si recupera un canale di notifica push da Windows Push Notification Services (WNS).
CreatePushNotificationChannelForApplicationAsync(String)	Crea un oggetto, associato a un'app specificata, tramite cui si recupera un canale di notifica push da Servizi notifica push Windows (WNS). L'app specificata deve trovarsi nello stesso pacchetto dell'app chiamante. Questo overload deve essere chiamato solo da un pacchetto con più app, la maggior parte delle app deve usare il metodo senza parametri.
CreatePushNotificationChannelForSecondaryTileAsync(String)	Crea un oggetto, associato a un riquadro secondario, tramite il quale si recupera un canale di notifica push da Windows Push Notification Services (WNS). Il riquadro può essere un riquadro secondario dell'app chiamante o qualsiasi altra app nello stesso pacchetto.
GetDefault()	Ottiene il gestore per l'utente attivo.
GetForUser(User)	Ottiene le notifiche push per l'utente specificato.

Eventi

ChannelsRevoked

Generato quando il canale push viene revocato, in modo da poter richiedere immediatamente un nuovo canale. Ciò riduce al minimo i tempi di inattività derivanti dall'uso di un canale WNS revocato. Il tipo di argomenti dell'evento è PushNotificationChannelsRevokedEventArgs.

Vedi anche

• PushNotificationChannel
• Panoramica di Servizi notifica Push Windows (WNS)
• Esempio di notifiche push e periodiche (archiviato)
• Guida introduttiva: Invio di una notifica push
• Come richiedere, creare e salvare un canale di notifica
• Intestazioni delle richieste e delle risposte per Servizi notifica Push Windows