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-Instanz ab, die einem MessageWebSocket -Objekt zugeordnet ist.
Ein MessageWebSocketControl-Objekt wird automatisch mit dem übergeordneten MessageWebSocket-Objekt erstellt. Die MessageWebSocketControl-Instanz kann dann zum Abrufen oder Festlegen von Steuerelementdaten verwendet werden, die vom MessageWebSocket-Objekt verwendet werden. Diese Eigenschaften für die MessageWebSocketControl-Instanz umfassen Folgendes:
- MaxMessageSize – Die maximale Nachrichtengröße in Bytes 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, der zum Senden von Daten in einem MessageWebSocket-Objekt verwendet werden soll.
- ProxyCredential – Die Anmeldeinformationen , die für die Authentifizierung beim Proxyserver über die HTTP-Headerauthentifizierung mithilfe eines MessageWebSocket-Objekts verwendet werden sollen.
- Serveranmeldeinformationen – Die Anmeldeinformationen, die zum Authentifizieren 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 Verbindungs-Handshake an 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 des MessageWebSocket geändert werden. Auf diese Weise kann eine App bei Bedarf zwischen binären und UTF-8-Nachrichten wechseln.
Die OutboundBufferSizeInBytes-Eigenschaft muss festgelegt werden, bevor das MessageWebSocket verbunden ist. Wenn Sie diese Eigenschaft festlegen, nachdem das MessageWebSocket verbunden ist, hat keine Auswirkung.
Änderungen an anderen Eigenschaftswerten im MessageWebSocketControl-Objekt müssen festgelegt werden, bevor das MessageWebSocket verbunden ist. 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 auftreten.