WebSocketKeepAlive Classe

Définition

Espace de noms:

Windows.Networking.Sockets

Permet d’envoyer un protocole WebSocket keep-alive sur un WebSocket connecté.

public ref class WebSocketKeepAlive sealed : IBackgroundTask

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class WebSocketKeepAlive final : IBackgroundTask

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WebSocketKeepAlive : IBackgroundTask

Public NotInheritable Class WebSocketKeepAlive
Implements IBackgroundTask

Héritage

Object Platform::Object IInspectable WebSocketKeepAlive

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IBackgroundTask

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

La classe WebSocketKeepAlive est utilisée conjointement avec la classe ControlChannelTrigger et les interfaces associées pour activer les status réseau en temps réel et les déclencheurs pour les classes StreamWebSocket et MessageWebSocket. Les déclencheurs de canal de contrôle sont utilisés par les applications réseau de longue durée pour réduire l’utilisation du réseau et des ressources système. Les déclencheurs réseau permettent à une application de passer en mode basse consommation pendant des périodes tout en conservant les connexions réseau établies intactes, mais dans un état de faible consommation. Une application peut définir un déclencheur keep-alive utilisé par le système pour savoir quand l’application doit se réveiller et envoyer un paquet webSocket keep-alive.

Une application UWP est normalement suspendue lorsqu’elle n’est plus au premier plan. Il existe certaines exceptions où une application ne doit pas être suspendue (impression active, accès à un flux audio et transfert de fichiers en arrière-plan, par exemple). La classe ControlChannelTrigger permet à une application réseau qui a établi une connexion WebSocket d’informer le système que la connexion réseau doit rester opérationnelle et que le système doit réveiller l’application suspendue lorsque des données réseau sont reçues pour l’application ou pour envoyer un paquet webSocket keep-alive.

WebSocketKeepAlive est utilisé comme TaskEntryPoint pour un maintien en vie dans ControlChannelTrigger. Un développeur doit écrire du code pour gérer la réception des données.

Pour plus d’informations sur la suspension et la mise en éveil d’une application, consultez Définition des options de connectivité en arrière-plan.

Pour plus d’informations sur les trames de contrôle keep-alive webSocket, consultez le protocole WebSocket.

Constructeurs

WebSocketKeepAlive()

Crée un objet WebSocketKeepAlive .

Méthodes

Run(IBackgroundTaskInstance)

Envoie un protocole WebSocket keep-alive sur un WebSocket connecté.