MessageWebSocket.Control 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得 MessageWebSocket 物件上的套接字控制資料。
public:
property MessageWebSocketControl ^ Control { MessageWebSocketControl ^ get(); };
MessageWebSocketControl Control();
public MessageWebSocketControl Control { get; }
var messageWebSocketControl = messageWebSocket.control;
Public ReadOnly Property Control As MessageWebSocketControl
屬性值
MessageWebSocket 物件上的 socket 控制資料。
備註
Control 屬性會取得與 MessageWebSocket 物件相關聯的 MessageWebSocketControl 實例。
MessageWebSocketControl 物件會自動以父 MessageWebSocket 物件建立。 接著可以使用 MessageWebSocketControl 實例來取得或設定 MessageWebSocket 物件所使用的控制資料。 MessageWebSocketControl 實例上的這些屬性包括以下幾項:
- MaxMessageSize - 在 MessageWebSocket 物件上設定 WebSocket 訊息的最大訊息大小(以位元組為單位)。
- MessageType - 在 MessageWebSocket 物件上設定用於寫入操作的 WebSocket 訊息類型。
- OutboundBufferSizeInBytes - 用於傳送 MessageWebSocket 物件資料的 send 緩衝區大小(位元組)。
- ProxyCredential - 用於透過 HTTP 標頭認證,使用 MessageWebSocket 物件向代理伺服器進行認證的憑證。
- ServerCredential - 用於透過 HTTP 標頭認證,使用 MessageWebSocket 物件向 WebSocket 伺服器進行認證的憑證。
- SupportedProtocols - 獲得一個集合,可用來新增支援子協定清單,並在連線握手時向伺服器公告。
SupportedProtocols 屬性會取得該屬性的值,並可隨時呼叫。
MessageType 屬性可在 MessageWebSocket 連接前後隨時更改。 這讓應用程式能在需要時切換二進位與 UTF-8 訊息。
在連接 MessageWebSocket 之前,必須先設定 OutboundBufferSizeInBytes 屬性。 在 MessageWebSocket 連接後設定此屬性則無效。
對於 MessageWebSocketControl 上其他屬性值的變更,必須在連接 MessageWebSocket 之前設定。 因此,如果你需要對 MaxMessageSize、OutboundBufferSizeInBytes、ProxyCredential 或 ServerCredential 屬性做變更,這些變更必須在成功呼叫 MessageWebSocket 上的 ConnectAsync 方法之前完成。