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物件上的通訊端控制項資料。
備註
Control 屬性會取得與 MessageWebSocket 物件相關聯的 MessageWebSocketControl實例。
MessageWebSocketControl物件會自動使用父MessageWebSocket物件建立。 MessageWebSocketControl實例接著可用來取得或設定MessageWebSocket物件所使用的控制項資料。 MessageWebSocketControl實例上的這些屬性包括下列各項：
- MaxMessageSize - MessageWebSocket 物件上要設定之 WebSocket 訊息的最大訊息大小，以位元組為單位。
- MessageType - 要針對寫入作業在 MessageWebSocket 物件上設定的 WebSocket 訊息類型。
- OutboundBufferSizeInBytes - 用來在 MessageWebSocket 物件上傳送資料的傳送緩衝區大小，以位元組為單位。
- ProxyCredential - 用來透過 使用 MessageWebSocket 物件的 HTTP 標頭驗證向 Proxy 伺服器進行驗證的認證。
- ServerCredential - 用來透過 使用 MessageWebSocket 物件的 HTTP 標頭驗證向 WebSocket 伺服器進行驗證的認證。
- SupportedProtocols - 取得集合，此集合可用來新增支援子通訊協定的清單，在連線交握期間將公告給伺服器。
SupportedProtocols屬性會取得這個屬性的值，而且可以隨時呼叫。
MessageType屬性可以隨時在MessageWebSocket連線之前或之後變更。 這可讓應用程式視需要切換二進位和 UTF-8 訊息。
在MessageWebSocket連線之前，必須先設定OutboundBufferSizeInBytes屬性。 在 MessageWebSocket 連接之後設定此屬性沒有任何作用。
在 MessageWebSocketControl 連線之前，必須先設定 MessageWebSocket 上任何其他屬性值的變更。 因此，如果您需要對MaxMessageSize、OutboundBufferSizeInBytes、ProxyCredential或ServerCredential屬性進行變更，則必須在MessageWebSocket上成功呼叫ConnectAsync方法之前發生這些變更。