WebSocketSharp中WebSocket类

websocket-sharp.clone,

Version=1.0.2.39869

WebSocket由方法调用事件改为实例化委托调用，两种构造

1.构造函数

第一种

//
        // 摘要:
        //     Initializes a new instance of the WebSocketSharp.WebSocket class with the specified
        //     WebSocket URL and subprotocols.
        //
        // 参数:
        //   url:
        //     A System.String that represents the WebSocket URL to connect.
        //
        //   cancellationToken:
        //     The System.Threading.CancellationToken used to cancel websocket operations.
        //
        //   fragmentSize:
        //     Set the size of message packages. Smaller size equals less memory overhead when
        //     sending streams.
        //
        //   onOpen:
        //     Delegate to be invoked when the WebSocket connection has been established.
        //
        //   onClose:
        //     Delegate to be invoked when the WebSocket connection has been closed.
        //
        //   onError:
        //     Delegate to be invoked when the WebSocketSharp.WebSocket gets an error.
        //
        //   protocols:
        //     An array of System.String that contains the WebSocket subprotocols if any. Each
        //     value of protocols must be a token defined in http://tools.ietf.org/html/rfc2616#section-2.2.
        //
        //   onMessage:
        //     Delegate to be invoked when the WebSocketSharp.WebSocket receives a message.
        //
        // 异常:
        //   T:System.ArgumentException:
        //     url is invalid.
        //     -or-
        //     protocols is invalid.
        //
        //   T:System.ArgumentNullException:
        //     url is null.
        public WebSocket(string url, CancellationToken cancellationToken = default(CancellationToken), int fragmentSize = 102392, Func<Task> onOpen = null, Func<CloseEventArgs, Task> onClose = null, Func<MessageEventArgs, Task> onMessage = null, Func<ErrorEventArgs, Task> onError = null, params string[] protocols);

参数说明：

url：要连接websocket url连接字符串

cancellationToken：用于取消websocket操作，线程

fragmentSize：消息包大小

onOpen：建立连接时调用的委托

onClose：连接关闭时调用的位图

onError：委托在WebSocketSharp时调用。WebSocket得到一个错误。

protocols：协议，每一个协议的值必须是在http://tools.ietf.org/html/rfc2616#section-2.2中定义的令牌

onMessage：WebSocket接收到一条消息

异常：

System.ArgumentException：URL无效或协议无效

System.ArgumentNullException：URL为空

第二种

//
        // 摘要:
        //     Initializes a new instance of the WebSocketSharp.WebSocket class with the specified
        //     WebSocket URL and subprotocols.
        //
        // 参数:
        //   url:
        //     A System.String that represents the WebSocket URL to connect.
        //
        //   sslAuthConfiguration:
        //     A ClientSslAuthConfiguration for securing the connection.
        //
        //   cancellationToken:
        //     The System.Threading.CancellationToken used to cancel websocket operations.
        //
        //   fragmentSize:
        //
        //   onOpen:
        //     Delegate to be invoked when the WebSocket connection has been established.
        //
        //   onClose:
        //     Delegate to be invoked when the WebSocket connection has been closed.
        //
        //   onError:
        //     Delegate to be invoked when the WebSocketSharp.WebSocket gets an error.
        //
        //   protocols:
        //     An array of System.String that contains the WebSocket subprotocols if any. Each
        //     value of protocols must be a token defined in http://tools.ietf.org/html/rfc2616#section-2.2.
        //
        // 异常:
        //   T:System.ArgumentException:
        //     url is invalid.
        //     -or-
        //     protocols is invalid.
        //
        //   T:System.ArgumentNullException:
        //     url is null.
        public WebSocket(string url, ClientSslConfiguration sslAuthConfiguration, CancellationToken cancellationToken = default(CancellationToken), int fragmentSize = 102392, Func<Task> onOpen = null, Func<CloseEventArgs, Task> onClose = null, Func<MessageEventArgs, Task> onMessage = null, Func<ErrorEventArgs, Task> onError = null, params string[] protocols);

和第一种唯一区别多了一个身份验证sslAuthConfiguration

2.属性

Cookies：获取websocket中http cookie

Extensions：获取websocket扩展

IsSecure：获取是否安全连接

Origin：获取或设置http标头

Protocol：获取子协议

ReadyState：获取联系状态，分别是Connecting、Open、Closing和Closed四个状态

WaitTime：获取设置ping和关闭响应时间，毫秒

3.方法

Close()、Close(CloseStatusCode code)、Close(CloseStatusCode code, string reason);：分为直接关闭、状态码关闭、状态码+关闭原因三种方式

bool Connect()：建立连接

Dispose()：关闭连接，条件是状态码是Away

Uri GetUrl()：获取URL

bool IsAlive()：是否活动状态

bool Ping()、bool Ping(string message)：发送ping、发送指定ping消息

boo Send()：发送数据分为二进制、数据流、字符串以及数据流+长度四种参数

SetCookie(Cookie cookie)：设置cookie

SetCredentials(string username, string password, bool preAuth)：设置HTTP身份验证用户名、密码和认证

SetProxy(string url, string username, string password)：设置HTTP代理