导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

StreamSocketListener Class

支持侦听使用 TCP 流套接字或 Bluetooth RFCOMM 的传入网络连接。

语法


var streamSocketListener = new Windows.Networking.Sockets.StreamSocketListener();

特性

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

成员

StreamSocketListener类 具有这些类型的成员:

构造函数

StreamSocketListener类 具有这些构造函数。

构造函数说明
StreamSocketListener Creates a new StreamSocketListener object.

 

事件

StreamSocketListener类 具有这些事件。

事件说明
ConnectionReceived An event that indicates that a connection was received on the StreamSocketListener object.

 

方法

The StreamSocketListener 类 具有这些方法。 对于 C#、Visual Basic 和 C++,它还继承方法于Object 类.

方法说明
BindEndpointAsync Starts a bind operation on a StreamSocketListener to a local hostname and a local service name.
BindServiceNameAsync(String) Starts a bind operation on a StreamSocketListener to a local service name.
BindServiceNameAsync(String, SocketProtectionLevel) Starts a bind operation on a StreamSocketListener to a local service name with a specified SocketProtectionLevel to set on any bound sockets.
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) Starts a socket bind operation on a StreamSocketListener to a local service name on a specified network adapter with a specified SocketProtectionLevel to set on any bound sockets.
Close [C++, JavaScript]Closes the StreamSocketListener object.
Dispose [C#, VB]Performs tasks associated with freeing, releasing, or resetting unmanaged resources.

 

属性

StreamSocketListener类 具有这些属性。

属性访问类型说明

Control

只读Gets socket control data on a StreamSocketListener object.

Information

只读Gets socket information for the StreamSocketListener object.

 

备注

StreamSocketListener 类支持侦听使用 TCP 流套接字的传入网络连接并接受该连接。

操作典型的顺序如下:

处理异常

当你在 StreamSocketListener 类上调用异步方法时,必须编写代码以处理异常。 异常可能来自参数验证错误、名称解析错误和网络错误。因网络错误(例如,断开连接、连接失败和服务器故障)导致的异常随时都可能发生。 这些错误将导致引发异常。未经您的应用程序处理的异常可能导致整个应用程序被运行时终止。

Windows.Networking.Sockets 命名空间有一个方便的帮助器方法和枚举,用于在使用套接字时处理错误。这可用于应用程序中的特定网络异常的不同处理方式。针对参数验证错误,应用程序还使用异常中的 HRESULT,以详细了解有关导致该异常的错误的信息。

有关可能的异常以及如何处理异常的更多信息,请参见处理网络应用程序中的异常

在 Windows Server 2012 上使用 StreamSocketListener

在 Windows Server 2012 和 Windows Server 2012 R2 中,Windows.Networking.dll 会无法加载(它用于实现 Windows.Networking.Sockets 命名空间中的大多数类),除非启用了媒体基础功能。这样一来,如果应用程序使用 StreamSocketListenerWindows.Networking.Sockets 命名空间中的相关套接字类,那么当禁用 Media Foundation 功能时,该应用程序将失败。Windows Server 2012 或 Windows Server 2012 R2 安装时会禁用 Media Foundation 功能。

可以通过使用服务器管理器或在命令提示或脚本中输入以下文本在 Windows Server 2012 或 Windows Server 2012 R2 上启用 Media Foundation 功能。

dism /online /enable-feature /featurename:ServerMediaFoundation

启用 Media Foundation 功能后,系统会提示用户重新启动。一旦计算机重新启动,Windows.Networking.Sockets 命名空间中用于套接字和 WebSocket 的类将按预期工作。

要求

最低支持客户端

Windows 8 [Windows 应用商店应用程序, 桌面应用程序]

最低支持服务器

Windows Server 2012 [Windows 应用商店应用程序, 桌面应用程序]

最低支持电话

Windows Phone 8

命名空间

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

元数据

Windows.winmd

DLL

Windows.Networking.dll

Capabilities

internetClientServer
privateNetworkClientServer
ID_CAP_NETWORKING [Windows Phone]

另请参见

其他资源
连接到网络服务(使用 JavaScript 和 HTML 的 Windows Store 应用程序)
连接到网络服务(使用 C#/VB/C++ 和 XAML 的 Windows Store 应用程序)
处理网络应用程序中的异常
如何使用高级套接字控件(使用 JavaScript 和 HTML 的 Windows Store 应用程序)
如何使用高级套接字控件(使用 C#/VB/C++ 和 XAML 的 Windows Store 应用程序)
快速入门:使用流套接字连接到网络资源(使用 JavaScript 和 HTML 的 Windows Store 应用程序)
疑难解答和调试网络连接
引用
IClosable
Object
StreamSocket
StreamSocketListenerConnectionReceivedEventArgs
StreamSocketListenerControl
StreamSocketListenerInformation

 

 

显示:
© 2014 Microsoft