MailboxShell 1.0.0

.NET Standard 2.0
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package MailboxShell --version 1.0.0
NuGet\Install-Package MailboxShell -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="MailboxShell" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MailboxShell --version 1.0.0
#r "nuget: MailboxShell, 1.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install MailboxShell as a Cake Addin
#addin nuget:?package=MailboxShell&version=1.0.0

// Install MailboxShell as a Cake Tool
#tool nuget:?package=MailboxShell&version=1.0.0


Library, that provides Mailbox class. The Mailbox class is a shell for a Socket object for a more simple network packets sending and receiving. So it segments TCP traffic for packets and returns data in this view.

How to use

  1. Get the Socket object
  2. Create Mailbox by Mailbox mailbox = new Mailbox(socket)

Network packets sending and receiving completes by mailbox.tick(); function in the NonBlocking mode. I.E. the best solution is to call this method with some interval (you can create a special thread to call this). mailbox.tick(); returns false when an error occurs or remote host is diconnected

Send a packet

  1. Create Packet object by Packet packet = new Packet([yourdata : byte[]]); (for example Packet packet = new Packet(Encoding.UTF8.GetBytes("Hello!")))
  2. To send packet call mailbox.Send(packet)
  3. Call mailbox.Tick()

Receive a packet

  1. Call mailbox.Tick() in main or other thread with some time intervals
  2. To receive packet on connected host use mailbox.Next() to get a packet if any packet is received (null else) or mailbox.ForeachReceived() to get all received packets Enumerator or if your update frequency is enought it's better to use mailbox.GetAllReceived() to get all received packets. It's better to use GetAllReceived method only to get all packets in one order or Next with ForeachReceived if you want to get each of packets separately !!!Don't forget to call mailbox.tick()!!!
  3. Received data bytes array is in field

Constructor args

Mailbox class has constructor: public Mailbox(Socket socket, int maxReceiveFragmentsPerTick = 64, int sendPacketsPerTick = 0, int maxPacketSize = 0)

  • Socket socket - socket that this object will be the facade of
  • int maxReceiveFragmentsPerTick - limit of received fragments per tick
  • int sendPacketsPerTick - limit of packets, that can be sended per tick
  • int maxPacketSize - limit of received packet size

Other properties and methods

  • bool IsConnected - checks if socket is connected (Connected socket property)
  • void Close() - close socket
  • bool IsSendQueueEmpty - checks if send queue is empty
  • void ClearReceived() - clears received packet queue
  • void ClearReceivedQueue() - clears send packet queue
  • void ClearAll() - clears both packet queues
  • Packet Packet.CloneDataRef() - returns new ready for sending Packet with some data ref

Mailbox's owner

  • You can set owner object of mailbox by void SetOwner(IMailboxOwner) method and get it by TYPE GetOwner<TYPE>() method.
  • Owner object must implement IMailboxOwner interface and have MailboxSafe object

For example:

public class ClientInfo : IMailboxOwner { 

	public MailboxSafe MailboxSafe { get; } = new MailboxSafe();
  • Also call mailbox.RemoveOwner() to remove owner object link.
  • Owner link methods are thread-safe, but don't use it too often. The purpose of these methods is to bind mailbox owner object in the start of handling
  • Also you can use GetMailbox, SetMailbox, RemoveMailbox IMailboxOwner's extension methods. They call similar methods in owned mailbox


(You can find the Test project in this repository MailboxShell solution) Lightweight example:

Socket socket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
socket.Connect(IPAddress.Parse(SERVER_IP), SERVER_PORT);
Mailbox mailbox = new Mailbox(socket);

while(true) {
	string message = Console.ReadLine();
	mailbox.Send(new Packet(Encoding.UTF8.GetBytes(message)));
	while(true) {
		Packet receivedPacket = mailbox.Next(); //Try to get the next packet
		if(receivedPacket != null) {
			Console.WriteLine($"Server response: \"{Encoding.UTF8.GetString(}\"");
Socket serverSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
serverSocket.Bind(new IPEndPoint(IPAddress.Parse(ip), port));
Mailbox mailbox = new Mailbox(serverSocket.Accept());
while(true) {
	mailbox.Tick(); //Tick to receive
	foreach(Packet packet in mailbox.SwapGetReceived()) {
		string message = Encoding.UTF8.GetString(; //Get message from
		mailbox.Send(new Packet(Encoding.UTF8.GetBytes("Echo: " + message))); //Send response
	mailbox.Tick(); //Tick to send (but both ticks can be in one in this case)
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.0-beta 152 8/28/2021
1.0.0 226 5/16/2021