Client/server communication system utilizing asynchronous .NET sockets via an Event-based Asynchronous Pattern (EAP) on top of an IAsyncResult Pattern with thread pools (I/O completion ports) and a binary packet-based TCP communications for maximum concurrency, capacity, performance and scalability.
Visual Basic
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

.NET Sockets

Note: this project has been re-tooled into an HTTP web server called Rapid Server which will eventually incorporate the binary protocol found here. Consider this project obsolete.

Client/server communication system utilizing asynchronous .NET sockets via an Event-based Asynchronous Pattern (EAP) on top of an IAsyncResult Pattern with thread pools (I/O completion ports) and a binary packet-based TCP communications for maximum concurrency, capacity, performance and scalability.

Built in the heyday of hobby game programming, perhaps before Protobuf (Google) and Thrift (Facebook) were a thing, this project was aiming to achieve something similar - as a universal networking framework for game development.


In the screenshot above, multiple clients connect to and relay messages to the server, which may then relay other messages back to the client depending on the message recieved. I do realize the above screenshot shows a broken chat system because the clients cannot see eachother's messages, so I'll update this soon to show how custom packets can be designed and handled by the server/clients.

How it works

The engine buffers large messages and data transfers by breaking them down into smaller fixed-size packets and reassembling them on the receiving end. Utilizes high performance .NET Framework natives such as TCP Sockets, Asynchronous BeginReceive/EndReceive methods, Message Queue, BinaryFormatter Serialization, Byte-level BlockCopy, etc. This is quite basically an asynchronous version of .NET's pre-included TCP Client which only functions in synchronous blocking mode.

One way around traditional blocking sockets is to spawn each socket as a separate process or thread, but this can have limitations on the number of client connections due to the high number of threads the operating system has to switch between. However, the Windows kernel provides a low level system for completing asynchronous calls - I/O completion ports. DotNetSockets utilizies this - alongside event-based async - to handle concurrency/parallelism as efficiently as possible.

"Imagine using a blocking socket on a multiplayer game. Each client would be completely stopped, frozen in place, until some data was received." -Game Coding Complete


Using OOP principles, the idea is to offer a base packet object which can be inherited or overridden, allowing for custom packets that encapsulate any data structure using binary serialization, sending those packets to the server, and having the server parse the packets into their native structures, allowing OOP access to the data on both sides. The server can then respond by doing something or sending a message/command back to one or more clients. This allows the server to be the final authoritative voice, rather than clients communicating directly (ad-hoc) which would allow for a greater possibility of cheating. This type of multiplayer game networking architecture ("netcode") is used in Valve's Source Engine (Half-Life 2) and many others.

May be useful as a learning tool or starting point for multiplayer video game programming in Windows.

Simple usage scenario

The code snippet below demonstrates a very simple full lifecycle of the application:

' create a server and start it:
Dim WithEvents server As New SocketServer

' create a client and connect it to the server:
Dim client As New SocketClient("8989", "")

' send a message from the client to the server:
client.SendMessageToServer("/say Hi server!")

' at this point an event is raised at the server so our
' custom logic checks the message then does something...
Case "/say"
    SendMessageToClient("/say Hi client!", current_client)

' disconnect the client from the server

' stop the server


The server can handle connections up to the OS port limit:


It can handle a high number of requests without failure:


The client app has a stress test built in, but I mostly use ApacheBench, siege and WeigHTTP for comparing results with other servers now. Benchmarks and optimizations will be an ongoing process, so rather than spamming this readme with these results, they will be posted to my website, along with insight into the optimizations being performed.


Roadmap / Future Challenges

  • Implement the publish/subscribe pattern for supporting multiple/individual channels of communication.
  • Implement a RESTful HTTP web server component.
  • Experiment with connecting to the server via HTML5 WebSockets.
  • Update the APM (Asynchronous Programming Model) + EAP (Event-based Asynchronous Pattern) to TAP (Task-based Asynchronous Pattern) which is available in .NET framework 4.0.
  • Optimize the concurrency issue surrounding large numbers of concurrent processes such as starting up 1000 instances of php-cgi.exe. Turns out I've been using it incorrectly (as CGI instead of FastCGI).
  • Do more benchmarks with real content and compare to other servers such as IIS, nginx, vert.x.
  • Look into IIS Hostable Web Core.
  • Flesh out the binary protocol and HTTP protocol into modular first-class citizens that can be used together or separately.


[1] Multithreaded Programming with the Event-based Asynchronous Pattern (MSDN)
[2] Deciding When to Implement the Event-based Asynchronous Pattern (MSDN)
[3] Simplify Asynchronous Programming with Tasks (MSDN Magazine)
[4] IAsyncResult Interface (MSDN)
[5] Asynchronous method invocation (Wikipedia)
[6] Get Closer to the Wire with High-Performance Sockets in .NET


This was developed as a sub-component for a personal project (Carcassonne board game in .NET) which I have since decided would be more suited to a website platform using websockets and a similar architecture.