StreamWebSocketControl 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在 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
- 繼承
- 屬性
- 實作
Windows 需求
裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
API contract |
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
|
應用程式功能 |
internetClient
privateNetworkClientServer
|
備註
StreamWebSocketControl 類別可讓您存取 StreamWebSocket 物件上的進階通訊端控制資料。
StreamWebSocketControl 物件會自動使用父 StreamWebSocket 物件建立。 StreamWebSocket.Control屬性可讓您存取相關聯的 StreamWebSocketControl 物件。
在 StreamWebSocket 連線之前,必須先設定 StreamWebSocketControl 屬性值的任何變更。 因此,如果您需要對NoDelay、OutboundBufferSizeInBytes、ProxyCredential、ServerCredential或SupportedProtocols屬性進行變更,則必須在StreamWebSocket上成功呼叫ConnectAsync方法之前發生這些變更。
下列範例會建立 StreamWebSocket,然後示範如何將 StreamWebSocketControl.NoDelay 屬性設定為 false。 (其他屬性可能會以類似的方式設定。) 完成之後,應用程式就可以連線 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.
如需使用 StreamWebSocketControl 的詳細資訊,請參閱 如何使用進階 WebSocket 控制項。
版本歷程記錄
Windows 版本 | SDK 版本 | 新增值 |
---|---|---|
1607 | 14393 | IgnorableServerCertificateErrors |
1709 | 16299 | ActualUnsolicitedPongInterval |
1709 | 16299 | ClientCertificate |
1709 | 16299 | DesiredUnsolicitedPongInterval |
屬性
ActualUnsolicitedPongInterval |
允許應用程式取得實際的未經請求 WebSocket PONG 間隔。 |
ClientCertificate |
取得用戶端在建立安全 WebSocket 連線時所提供的憑證。 |
DesiredUnsolicitedPongInterval |
允許應用程式取得並設定所需的未經請求 WebSocket PONG 間隔。 |
IgnorableServerCertificateErrors |
取得可忽略的伺服器憑證錯誤清單。 取得此清單,並針對您想要在安全 WebSocket (wss://通訊協定) 伺服器憑證驗證程式期間忽略的伺服器憑證錯誤新增ChainValidationResult值。 |
NoDelay |
值,指出 是否在 StreamWebSocket 物件上使用 Nagle 演算法。 |
OutboundBufferSizeInBytes |
要用於 在 StreamWebSocket 物件上傳送資料的傳送緩衝區大小,以位元組為單位。 |
ProxyCredential |
用來透過使用 StreamWebSocket 物件的 HTTP 標頭驗證向 Proxy 伺服器進行驗證的認證。 |
ServerCredential |
用來透過使用 StreamWebSocket 物件的 HTTP 標頭驗證向 WebSocket 伺服器驗證的認證。 |
SupportedProtocols |
取得集合,可用來新增支援子通訊協定的清單,這些子通訊協定將在連接交握期間公告至伺服器。 |