Lingua

WebSocketKeepAlive Classe

Definizione

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

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
Ereditarietà
Object Platform::Object IInspectable WebSocketKeepAlive
Attributi
Implementazioni

Requisiti Windows

Requisiti Descrizione
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 normalmente sospesa quando non è più in primo piano. Esistono alcune eccezioni in cui un'app non deve essere sospesa (ad esempio stampare attivamente, accedere a un flusso audio e trasferire i 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 dati di rete per l'app o per 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, come impostare le opzioni di connettività in background.

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

Costruttori

Nome Descrizione
WebSocketKeepAlive()

Crea un nuovo oggetto WebSocketKeepAlive .

Metodi

Nome Descrizione
Run(IBackgroundTaskInstance)

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

Si applica a