MessageWebSocket Class

Unterstützt Netzwerkkommunikation, die das Lesen und Schreiben von ganzen Nachrichten mithilfe eines WebSocket ermöglicht.

Syntax


var messageWebSocket = new Windows.Networking.Sockets.MessageWebSocket();

Attribute

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Member

MessageWebSocketKlasse hat diese Membertypen:

Konstruktoren

MessageWebSocketKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
MessageWebSocket Creates a new MessageWebSocket object.

 

Ereignisse

MessageWebSocketKlasse hat diese Ereignisse.

EreignisBeschreibung
Closed Occurs when a close frame is received on the MessageWebSocket object as part of the close handshake.
MessageReceived An event that indicates that a message was received on the MessageWebSocket object.

 

Methoden

The MessageWebSocket Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
Close() [C++, JavaScript]Closes the MessageWebSocket object and sends an empty close frame to the server.
Close(UInt16, String) Closes the MessageWebSocket object and indicates a reason for the closure.
ConnectAsync Starts an asynchronous operation to connect to a remote network destination on a MessageWebSocket object.
Dispose [C#, VB]Performs tasks associated with freeing, releasing, or resetting unmanaged resources.
SetRequestHeader Adds an HTTP request header to the HTTP request message used in the WebSocket protocol handshake by the MessageWebSocket object.

 

Eigenschaften

Der MessageWebSocketKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

Control

SchreibgeschütztGets socket control data on a MessageWebSocket object.

Information

SchreibgeschütztGets socket information on a MessageWebSocket object.

OutputStream

SchreibgeschütztGets the output stream to write to the remote network destination on a MessageWebSocket object.

 

Hinweise

Die MessageWebSocket-Klasse stellt eine meldungsbasierte Abstraktion des WebSocket-Protokolls zur Verfügung. Wenn MessageWebSocket verwendet wird, wird die gesamte WebSocket-Meldung in einen einzelnen Vorgang gelesen oder geschrieben. Die Verwendung von StreamWebSocket ermöglicht hingegen das Lesen von Abschnitten einer Meldung mit jedem Lesevorgang. So muss nicht die gesamte Meldung innerhalb eines Vorgangs gelesen werden.

Für UTF-8-Meldungen muss MessageWebSocket verwendet werden. StreamWebSocket unterstützt nur binäre Meldungen.

Behandeln von Ausnahmen

Sie müssen Code zum Behandeln von Ausnahmen schreiben, wenn Sie asynchrone Methoden für die MessageWebSocket-Klasse aufrufen. Ausnahmen können durch Parametervalidierungsfehler, Namensauflösungsfehler und Netzwerkfehler ausgelöst werden. Ausnahmen durch Netzwerkfehler (beispielsweise Verlust der Konnektivität, Verbindungsfehler und HTTP-Serverfehler) können jederzeit vorkommen. Durch diese Fehler werden Ausnahmen ausgelöst. Wenn sie nicht von der Anwendung verarbeitet wird, kann eine Ausnahme bewirken, dass die gesamte App von der Laufzeit beendet wird.

Der Windows.Networking.Sockets-Namespace hat eine bequeme Hilfsmethode und Enumeration für die Fehlerbehandlung bei Verwendung von WebSockets. Dies kann für eine alternative Behandlung bestimmter Netzwerkausnahmen in der App hilfreich sein. Eine App kann auch das HRESULT aus der Ausnahme bei Parametervalidierungsfehlern verwenden, um ausführlichere Informationen über den Fehler zu erhalten, der die Ausnahme ausgelöst hat.

Weitere Informationen über mögliche Ausnahmen und deren Behandlung finden Sie unter Behandeln von Ausnahmen in Netzwerk-Apps.

Verwenden von MessageWebSocket unter Windows Server 2012

Unter Windows Server 2012 und Windows Server 2012 R2 kann die Windows.Networking.dll, welche die meisten Klassen aus dem Windows.Networking.Sockets-Namespace implementiert, nur geladen werden, wenn die Media Foundation-Funktion aktiviert ist. Apps, die MessageWebSocket und zugehörige WebSocket-Klassen im Windows.Networking.Sockets-Namespace verwenden, scheitern daher, wenn die Media Foundation-Funktion deaktiviert ist. Windows Server 2012 oder Windows Server 2012 R2 wird mit deaktivierter Media Foundations-Funktion installiert.

Die Media Foundation-Funktion kann unter Windows Server 2012 oder Windows Server 2012 R2 mithilfe des Server-Managers oder durch Eingabe des folgenden Texts in eine Eingabeaufforderung oder in ein Skript aktiviert werden.

dism /online /enable-feature /featurename:ServerMediaFoundation

Nach dem Aktivieren der Media Foundation-Funktion wird der Benutzer aufgefordert, einen Neustart auszuführen. Nachdem der Computer neu gestartet wurde, wenden die Klassen für Sockets und WebSockets aus dem Windows.Networking.Sockets-Namespace wie erwartet arbeiten.

Anforderungen

Mindestens unterstützter Client

Windows 8 [Windows Store-Apps, Desktop-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Windows Store-Apps, Desktop-Apps]

Namespace

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

Metadaten

Windows.winmd

DLL

Windows.Networking.dll

Capabilities

internetClient
privateNetworkClientServer

Siehe auch

Anschließen an WebSockets
Behandeln von Ausnahmen in Netzwerk-Apps
Schnellstart: Verbinden mit einem MessageWebSocket
Beispiel für Verbinden mit WebSockets

 

 

Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.