Lingua

StreamWebSocketControl Classe

Definizione

Fornisce i dati del controllo socket in un oggetto StreamWebSocket .

public ref class StreamWebSocketControl sealed
public ref class StreamWebSocketControl sealed : IWebSocketControl2
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StreamWebSocketControl final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StreamWebSocketControl final : IWebSocketControl2
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class StreamWebSocketControl
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class StreamWebSocketControl : IWebSocketControl2
Public NotInheritable Class StreamWebSocketControl
Public NotInheritable Class StreamWebSocketControl
Implements IWebSocketControl2
Ereditarietà
Object Platform::Object IInspectable StreamWebSocketControl
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)
Funzionalità dell'app
internetClient privateNetworkClientServer

Commenti

La classe StreamWebSocketControl consente di accedere ai dati avanzati del controllo socket in un oggetto StreamWebSocket .

Un oggetto StreamWebSocketControl viene creato automaticamente con l'oggetto StreamWebSocket padre. La proprietà StreamWebSocket.Control fornisce l'accesso all'oggetto StreamWebSocketControl associato.

Eventuali modifiche ai valori delle proprietà StreamWebSocketControl devono essere impostate prima che streamWebSocket sia connesso. Di conseguenza, se è necessario apportare modifiche alle proprietà NoDelay, OutboundBufferSizeInBytes, ProxyCredential, ServerCredential o SupportedProtocols , queste modifiche devono verificarsi prima di una chiamata corretta al metodo ConnectAsync in StreamWebSocket.

Nell'esempio seguente viene creato un oggetto StreamWebSocket e viene illustrato come impostare la proprietà StreamWebSocketControl.NoDelay su false. Altre proprietà possono essere impostate in modo simile. Al termine, l'app può connettere StreamWebSocket.

using Windows.Networking.Sockets;

StreamWebSocket clientWebSocket = new StreamWebSocket();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
bool currentSetting = clientWebSocket.Control.NoDelay;

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientWebSocket.Control.NoDelay = false;

// Now you can call the ConnectAsync method to connect the StreamWebSocket.
#include <winrt/Windows.Networking.Sockets.h>
using namespace winrt;
...
Windows::Networking::Sockets::StreamWebSocket clientWebSocket;

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting.
bool currentSetting{ clientWebSocket.Control().NoDelay() };

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientWebSocket.Control().NoDelay(false);

// Now you can call the ConnectAsync method to connect the StreamWebSocket.
using namespace Windows::Networking::Sockets;

StreamWebSocket^ clientWebSocket = ref new StreamWebSocket();

// Get the current setting for this option.
// This isn't required, but it shows how to get the current setting .
bool currentSetting = clientWebSocket->Control->NoDelay;

// Set NoDelay to false so that the Nagle algorithm is not disabled.
clientWebSocket->Control->NoDelay = false;

// Now you can call the ConnectAsync method to connect the StreamWebSocket.

Per altre informazioni sull'uso di StreamWebSocketControl, vedere Come usare controlli WebSocket avanzati.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 IgnorableServerCertificateErrors
1709 16299 ActualUnsolicitedPongInterval
1709 16299 Certificato del Cliente
1709 16299 DesiredUnsolicitedPongInterval

Proprietà

Nome Descrizione
ActualUnsolicitedPongInterval

Consente a un'app di ottenere l'effettivo intervallo webSocket PONG non richiesto.

ClientCertificate

Ottiene il certificato fornito dal client quando è stata stabilita una connessione WebSocket sicura.

DesiredUnsolicitedPongInterval

Consente a un'app di ottenere e impostare l'intervallo di WebSocket PONG desiderato.

IgnorableServerCertificateErrors

Ottiene un elenco di errori di certificato server ignorabili. Ottenere questo elenco e aggiungere valori ChainValidationResult per gli errori del certificato server che si desidera ignorare durante il processo di convalida del certificato server WebSocket (protocollo wss:// ) sicuro.

NoDelay

Valore che indica se l'algoritmo Nagle viene utilizzato in un oggetto StreamWebSocket .

OutboundBufferSizeInBytes

Dimensioni, in byte, del buffer di invio da usare per l'invio di dati in un oggetto StreamWebSocket .

ProxyCredential

Credenziali da usare per l'autenticazione al server proxy tramite l'autenticazione dell'intestazione HTTP tramite un oggetto StreamWebSocket .

ServerCredential

Credenziali da usare per l'autenticazione al server WebSocket tramite l'autenticazione dell'intestazione HTTP tramite un oggetto StreamWebSocket .

SupportedProtocols

Ottiene una raccolta che può essere utilizzata per aggiungere un elenco di protocolli secondari supportati che verranno annunciati al server durante l'handshake di connessione.

Si applica a