StreamWebSocket-Klasse

StreamWebSocket Class

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

Syntax


var streamWebSocket = new Windows.Networking.Sockets.StreamWebSocket();

Attribute

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

Member

StreamWebSocketKlasse hat diese Membertypen:

Konstruktoren

StreamWebSocketKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
StreamWebSocket Creates a new StreamWebSocket object.

 

Ereignisse

StreamWebSocketKlasse hat diese Ereignisse.

EreignisBeschreibung
Closed Occurs when a close frame is received on the StreamWebSocket object as part of the close handshake.

 

Methoden

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

MethodeBeschreibung
Close() [C++, JavaScript]Closes the StreamWebSocket and sends an empty close frame to the server.
Close(UInt16, String) Closes the StreamWebSocket and indicates a reason for the closure.
ConnectAsync Starts an asynchronous operation to connect to a remote network destination on a StreamWebSocket 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 StreamWebSocket object.

 

Eigenschaften

Der StreamWebSocketKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

Control

SchreibgeschütztGets socket control data on a StreamWebSocket object.

Information

SchreibgeschütztGets socket information on a StreamWebSocket object.

InputStream

SchreibgeschütztGets the input stream to read from the remote destination on a StreamWebSocket object.

OutputStream

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

 

Hinweise

Die StreamWebSocket-Klasse stellt eine streambasierte Abstraktion des meldungsbasierten WebSocket-Protokolls zur Verfügung. Dies ist für Szenarien nützlich, bei denen große Dateien (wie Fotos oder Kinofilme) übertragen werden müssen. Die Verwendung von StreamWebSocket ermöglicht das Lesen von Abschnitten einer Meldung mit jedem Lesevorgang. So muss nicht die gesamte Meldung innerhalb eines Vorgangs gelesen werden (wie bei MessageWebSocket).

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

Behandeln von Ausnahmen

Sie müssen Code zum Behandeln von Ausnahmen schreiben, wenn Sie asynchrone Methoden für die StreamWebSocket-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 StreamWebSocket 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 StreamWebSocket 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
Schnellstart: Verbinden mit einem StreamWebSocket
Beispiel für Verbinden mit WebSockets
Beispiel ControlChannelTrigger StreamWebSocket

 

 

Anzeigen:
© 2017 Microsoft