MessageWebSocket.Control Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft Socketsteuerelementdaten für ein MessageWebSocket-Objekt ab.
public:
property MessageWebSocketControl ^ Control { MessageWebSocketControl ^ get(); };MessageWebSocketControl Control();public MessageWebSocketControl Control { get; }var messageWebSocketControl = messageWebSocket.control;Public ReadOnly Property Control As MessageWebSocketControlEigenschaftswert
Socketsteuerelementdaten für ein MessageWebSocket-Objekt .
Hinweise
Die Control-Eigenschaft ruft die MessageWebSocketControl-instance ab, die einem MessageWebSocket-Objekt zugeordnet ist.
Ein MessageWebSocketControl-Objekt wird automatisch mit dem übergeordneten MessageWebSocket-Objekt erstellt. Der MessageWebSocketControl-instance kann dann zum Abrufen oder Festlegen von Steuerungsdaten verwendet werden, die vom MessageWebSocket-Objekt verwendet werden. Diese Eigenschaften im MessageWebSocketControl-instance umfassen Folgendes:
- MaxMessageSize : Die maximale Nachrichtengröße in Byte für eine WebSocket-Nachricht, die für das MessageWebSocket-Objekt konfiguriert werden soll.
- MessageType : Der WebSocket-Nachrichtentyp, der für ein MessageWebSocket-Objekt für Schreibvorgänge konfiguriert werden soll.
- OutboundBufferSizeInBytes : Die Größe des Sendepuffers in Bytes, der zum Senden von Daten für ein MessageWebSocket-Objekt verwendet werden soll.
- ProxyCredential : Die Anmeldeinformationen, die zur Authentifizierung beim Proxyserver über die HTTP-Headerauthentifizierung mithilfe eines MessageWebSocket-Objekts verwendet werden sollen.
- ServerCredential : Die Anmeldeinformationen, die zur Authentifizierung beim WebSocket-Server über die HTTP-Headerauthentifizierung mithilfe eines MessageWebSocket-Objekts verwendet werden sollen.
- SupportedProtocols : Ruft eine Auflistung ab, die verwendet werden kann, um eine Liste der unterstützten Unterprotokolle hinzuzufügen, die während des Verbindungshandshakes für den Server angekündigt werden.
Die SupportedProtocols-Eigenschaft ruft den Wert dieser Eigenschaft ab und kann jederzeit aufgerufen werden.
Die MessageType-Eigenschaft kann jederzeit vor oder nach der Verbindung mit MessageWebSocket geändert werden. Dadurch kann eine App bei Bedarf zwischen binären und UTF-8-Nachrichten wechseln.
Die OutboundBufferSizeInBytes-Eigenschaft muss festgelegt werden, bevor messageWebSocket verbunden wird. Das Festlegen dieser Eigenschaft, nachdem messageWebSocket verbunden wurde, hat keine Auswirkung.
Änderungen an anderen Eigenschaftswerten in MessageWebSocketControl müssen festgelegt werden, bevor messageWebSocket verbunden wird. Wenn Sie daher Änderungen an den Eigenschaften MaxMessageSize, OutboundBufferSizeInBytes, ProxyCredential oder ServerCredential vornehmen müssen, müssen diese Änderungen vor einem erfolgreichen Aufruf der ConnectAsync-Methode im MessageWebSocket erfolgen.