WebSocketKeepAlive Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente di inviare un protocollo WebSocket keep-alive su 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à
- Attributi
- Implementazioni
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. |