WebSocketKeepAlive Classe

Definizione

Spazio dei nomi:

Windows.Networking.Sockets

Consente di inviare un protocollo WebSocket keep-alive su un WebSocket connesso.

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

Ereditarietà

Object Platform::Object IInspectable WebSocketKeepAlive

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IBackgroundTask

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La classe WebSocketKeepAlive viene usata insieme alla classe ControlChannelTrigger e alle interfacce correlate per abilitare lo stato e i trigger di rete in tempo reale per le classi StreamWebSocket e MessageWebSocket . I trigger del canale di controllo vengono usati dalle app di rete a esecuzione prolungata per ridurre al minimo l'utilizzo delle risorse di rete e di sistema. I trigger di rete consentono a un'app di passare a una modalità a basso consumo per periodi di tempo mantenendo intatte le connessioni di rete stabilite ma in uno stato a basso consumo. Un'app può impostare un trigger keep-alive usato dal sistema per quando l'app deve riattivarsi e inviare un pacchetto keep-alive WebSocket.

Un'app UWP viene in genere sospesa quando non è più in primo piano. Esistono alcune eccezioni in cui un'app non deve essere sospesa ,ad esempio stampando attivamente, accedendo a un flusso audio e trasferendo file in background. La classe ControlChannelTrigger consente a un'app di rete che ha stabilito una connessione WebSocket di notificare al sistema che la connessione di rete deve essere mantenuta operativa e che il sistema deve riattivare l'app sospesa quando vengono ricevuti i dati di rete per l'app o inviare un pacchetto keep-alive WebSocket.

WebSocketKeepAlive viene usato come TaskEntryPoint per un keep-alive in ControlChannelTrigger. Uno sviluppatore dovrà scrivere codice per gestire la ricezione dei dati.

Per altre informazioni sulla sospensione e la riattivazione di un'app, vedere Come impostare le opzioni di connettività in background.

Per altre informazioni sui frame di controllo keep-alive di WebSocket, vedere Il protocollo WebSocket.

Costruttori

WebSocketKeepAlive()

Crea un nuovo oggetto WebSocketKeepAlive .

Metodi

Run(IBackgroundTaskInstance)

Invia un keep-alive del protocollo WebSocket in un WebSocket connesso.