Langue

WebSocketKeepAlive Classe

Définition

Fournit la possibilité d’envoyer un protocole WebSocket keep-alive sur un WebSocket connecté.

public ref class WebSocketKeepAlive sealed : IBackgroundTask
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class WebSocketKeepAlive final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class WebSocketKeepAlive : 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
Implémente

Configuration requise pour Windows

Configuration requise Description
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 l’état et les déclencheurs réseau en temps réel pour les classes StreamWebSocket et MessageWebSocket . Les déclencheurs de canal de contrôle sont utilisés par des applications réseau de longue durée pour réduire l’utilisation des ressources réseau et système. Les déclencheurs réseau permettent à une application de passer à un mode à faible alimentation pendant des périodes de temps tout en conservant les connexions réseau établies intactes, mais dans un état à faible alimentation. Une application peut définir un déclencheur keep-alive utilisé par le système pour le moment où l’application doit se réveiller et envoyer un paquet de conservation de WebSocket.

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 être maintenue opérationnelle et que le système doit réveiller l’application suspendue lorsque les données réseau sont reçues pour l’application ou pour envoyer un paquet de conservation de WebSocket.

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 l’éveil d’une application, comment définir des options de connectivité en arrière-plan.

Pour plus d’informations sur les trames de contrôle de maintien en vie de WebSocket, consultez le protocole WebSocket.

Constructeurs

Nom Description
WebSocketKeepAlive()

Crée un objet WebSocketKeepAlive .

Méthodes

Nom Description
Run(IBackgroundTaskInstance)

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

S’applique à