| static private ValidateSubprotocol ( string subProtocol ) : void | ||
| subProtocol | string | |
| return | void | |
public static WebSocket CreateFromStream(
Stream stream,
bool isServer,
string?subProtocol,
TimeSpan keepAliveInterval)
{
if (stream == null)
{
throw new ArgumentNullException(nameof(stream));
}
if (!stream.CanRead || !stream.CanWrite)
{
throw new ArgumentException(!stream.CanRead ? SR.NotReadableStream : SR.NotWriteableStream, nameof(stream));
}
if (subProtocol != null)
{
WebSocketValidate.ValidateSubprotocol(subProtocol);
}
if (keepAliveInterval != Timeout.InfiniteTimeSpan && keepAliveInterval < TimeSpan.Zero)
{
throw new ArgumentOutOfRangeException(nameof(keepAliveInterval), keepAliveInterval,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall,
0));
}
return(ManagedWebSocket.CreateFromConnectedStream(stream, isServer, subProtocol, keepAliveInterval));
}
public static WebSocket CreateClientWebSocket(Stream innerStream,
string?subProtocol, int receiveBufferSize, int sendBufferSize,
TimeSpan keepAliveInterval, bool useZeroMaskingKey, ArraySegment <byte> internalBuffer)
{
ArgumentNullException.ThrowIfNull(innerStream);
if (!innerStream.CanRead || !innerStream.CanWrite)
{
throw new ArgumentException(!innerStream.CanRead ? SR.NotReadableStream : SR.NotWriteableStream, nameof(innerStream));
}
if (subProtocol != null)
{
WebSocketValidate.ValidateSubprotocol(subProtocol);
}
if (keepAliveInterval != Timeout.InfiniteTimeSpan && keepAliveInterval < TimeSpan.Zero)
{
throw new ArgumentOutOfRangeException(nameof(keepAliveInterval), keepAliveInterval,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall,
0));
}
if (receiveBufferSize <= 0 || sendBufferSize <= 0)
{
throw new ArgumentOutOfRangeException(
receiveBufferSize <= 0 ? nameof(receiveBufferSize) : nameof(sendBufferSize),
receiveBufferSize <= 0 ? receiveBufferSize : sendBufferSize,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall, 0));
}
// Ignore useZeroMaskingKey. ManagedWebSocket doesn't currently support that debugging option.
// Ignore internalBuffer. ManagedWebSocket uses its own small buffer for headers/control messages.
return(new ManagedWebSocket(innerStream, false, subProtocol, keepAliveInterval));
}
public void AddSubProtocol(string subProtocol)
{
ThrowIfReadOnly();
WebSocketValidate.ValidateSubprotocol(subProtocol);
// Duplicates not allowed.
foreach (string item in _requestedSubProtocols)
{
if (string.Equals(item, subProtocol, StringComparison.OrdinalIgnoreCase))
{
throw new ArgumentException(SR.Format(SR.net_WebSockets_NoDuplicateProtocol, subProtocol), nameof(subProtocol));
}
}
_requestedSubProtocols.Add(subProtocol);
}
internal static void ValidateOptions(string?subProtocol, int receiveBufferSize, int sendBufferSize, TimeSpan keepAliveInterval)
{
if (subProtocol != null)
{
WebSocketValidate.ValidateSubprotocol(subProtocol);
}
if (receiveBufferSize < MinReceiveBufferSize)
{
throw new ArgumentOutOfRangeException(nameof(receiveBufferSize), receiveBufferSize,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall, MinReceiveBufferSize));
}
if (sendBufferSize < MinSendBufferSize)
{
throw new ArgumentOutOfRangeException(nameof(sendBufferSize), sendBufferSize,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall, MinSendBufferSize));
}
if (receiveBufferSize > MaxBufferSize)
{
throw new ArgumentOutOfRangeException(nameof(receiveBufferSize), receiveBufferSize,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooBig,
nameof(receiveBufferSize),
receiveBufferSize,
MaxBufferSize));
}
if (sendBufferSize > MaxBufferSize)
{
throw new ArgumentOutOfRangeException(nameof(sendBufferSize), sendBufferSize,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooBig,
nameof(sendBufferSize),
sendBufferSize,
MaxBufferSize));
}
if (keepAliveInterval < Timeout.InfiniteTimeSpan) // -1 millisecond
{
throw new ArgumentOutOfRangeException(nameof(keepAliveInterval), keepAliveInterval,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall, Timeout.InfiniteTimeSpan.ToString()));
}
}
internal static void ValidateOptions(string subProtocol,
int receiveBufferSize,
int sendBufferSize,
TimeSpan keepAliveInterval)
{
// We allow the subProtocol to be null. Validate if it is not null.
if (subProtocol != null)
{
WebSocketValidate.ValidateSubprotocol(subProtocol);
}
ValidateBufferSizes(receiveBufferSize, sendBufferSize);
if (keepAliveInterval < Timeout.InfiniteTimeSpan) // -1
{
throw new ArgumentOutOfRangeException(nameof(keepAliveInterval), keepAliveInterval,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall, Timeout.InfiniteTimeSpan.ToString()));
}
}
public static WebSocket CreateClientWebSocket(Stream innerStream,
string subProtocol, int receiveBufferSize, int sendBufferSize,
TimeSpan keepAliveInterval, bool useZeroMaskingKey, ArraySegment <byte> internalBuffer)
{
if (innerStream == null)
{
throw new ArgumentNullException(nameof(innerStream));
}
if (!innerStream.CanRead || !innerStream.CanWrite)
{
throw new ArgumentException(!innerStream.CanRead ? SR.NotReadableStream : SR.NotWriteableStream, nameof(innerStream));
}
if (subProtocol != null)
{
WebSocketValidate.ValidateSubprotocol(subProtocol);
}
if (keepAliveInterval != Timeout.InfiniteTimeSpan && keepAliveInterval < TimeSpan.Zero)
{
throw new ArgumentOutOfRangeException(nameof(keepAliveInterval), keepAliveInterval,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall,
0));
}
if (receiveBufferSize <= 0 || sendBufferSize <= 0)
{
throw new ArgumentOutOfRangeException(
receiveBufferSize <= 0 ? nameof(receiveBufferSize) : nameof(sendBufferSize),
receiveBufferSize <= 0 ? receiveBufferSize : sendBufferSize,
SR.Format(SR.net_WebSockets_ArgumentOutOfRange_TooSmall, 0));
}
Memory <byte> internalMemoryBuffer =
internalBuffer.Count >= receiveBufferSize ? internalBuffer :
receiveBufferSize >= ManagedWebSocket.MaxMessageHeaderLength ? new byte[receiveBufferSize] :
Memory <byte> .Empty; // let ManagedWebSocket create it
return(ManagedWebSocket.CreateFromConnectedStream(innerStream, false, subProtocol, keepAliveInterval, internalMemoryBuffer));
}
