Click here to Skip to main content
15,860,859 members
Articles / Desktop Programming / XAML

Working with Sockets in C#

Rate me:
Please Sign up or sign in to vote.
4.73/5 (64 votes)
31 May 2013CPOL4 min read 472K   204   43
This article shows how to use sockets to send messages

Introduction

Sockets are getting more and more used nowadays. They provide a simple way to exchange data over the network. It's used, as an example, to exchange messages between users. You can go further more to transfer files and play "distributed" games and communicate multiple programs. Thanks to its powerful features, sockets are becoming a must to learn technology for developers.

As sockets are based on client/server architecture, this application is composed of a server and a client. The server will reserve a port number. Then it will listen to any upcoming client. The client then will attempt to connect to the server. When the connection succeeds, it will be possible to exchange text messages. When finished, the connection will be closed.

Using the code

To use sockets in .NET applications, we have to add the following using statements:

C#
using System.Net; 
using System.Net.Sockets; 

Now we can create a socket object:

C#
Socket sListener;    

Programming the server

Let's create a click event that will enable the created socket to set its IpEndPoint and the protocol type.

But before that, a socket needs permission to work, because it will use a closed port number. A window will appear demanding permission to allow sending data.

C#
permission = new SocketPermission(NetworkAccess.Accept, 
                   TransportType.Tcp, "", SocketPermission.AllPorts);

As sockets use a network to transmit data, it uses protocols. The most known in this context are UDP which is fast but not reliable, and TCP which is reliable but not fast. Reliability is recommended when sending messages. That's why I use TCP.

C#
sListener = new Socket(ipAddr.AddressFamily, SocketType.Stream, ProtocolType.Tcp); 

The socket needs to have an address. It's of type IpEndPoint. Each socket is identified through the IP address, which is useful to locate the host's machine, and the port number to identify which program is using the socket inside the machine.

C#
IPHostEntry ipHost = Dns.GetHostEntry(""); 
IPAddress ipAddr = ipHost.AddressList[0]; 
ipEndPoint = new IPEndPoint(ipAddr, 4510);  

Now we will associate our socket with the IpEndPoint:

C#
sListener.Bind(ipEndPoint);  

So that our socket is ready to use, let's start listening on the chosen port number (4510). You can choose another port number. But the client has to be aware about that. Listening will be handled through this button's event:

Place a socket in a listening state and specify how many client sockets could connect to it:

C#
sListener.Listen(10); 

The server will begin an asynchronous operation to accept an attempt. One of the powerful features of sockets is the use of the asynchronous programming model. Thanks to it, our program can continue running while the socket is performing actions.

C#
AsyncCallback aCallback = new AsyncCallback(AcceptCallback);
sListener.BeginAccept(aCallback, sListener); 

If there is any attempt from the client to connect, the following code will be executed:

C#
Socket listener = (Socket)ar.AsyncState; 
Socket handler  = listener.EndAccept(ar);  

To begin to asynchronously receive data, we need an array of type Byte for the received data, the zero-based position in the buffer, and the number of bytes to receive.

C#
handler.BeginReceive(buffer, 0, buffer.Length, 
          SocketFlags.None, new AsyncCallback(ReceiveCallback), obj); 

If the client sends any message, the server will try to get it. As sockets send data in binary type, converting  them to string type is necessary. It's good to know also that the server, and even the client, don't know anything about the length of the message or the time needed for listening to all of it. That's why we use a special string "<Client Quit>" to put in the end of the message to tell that the text message ends there. To receive data, BeginReceive is called:

C#
byte[] buffernew = new byte[1024];
obj[0] = buffernew;
obj[1] = handler;
handler.BeginReceive(buffernew, 0, buffernew.Length, 
        SocketFlags.None, new AsyncCallback(ReceiveCallback), obj);  

After receiving the client's messages, the server may want to reply. But it has to convert the string message in str to bytes data, because sockets manipulate bytes only.

C#
byte[] byteData = Encoding.Unicode.GetBytes(str);  

The server now will send data asynchronously to the connected socket:

C#
handler.BeginSend(byteData, 0, byteData.Length, 0, new AsyncCallback(SendCallback), handler); 

When using the asynchronous programming model to build this sample, there's no risk of application or interface blocking. It will seem like we are using multiple threads.

After writing code, you want to handle the different methods through a user interface. So you may have a UI like this:

Programming the client

The client will try to connect to the server. But it has to know its address.

After creating a SocketPermission for socket access restrictions and creating a socket with a matching IpEndPoint, we have to establish a connection to the remote server host:

C#
senderSock.Connect(ipEndPoint);

We have to note here that the created IpEndPoint will not be used to identify the client. But it'll be used to identify the server socket.

To send messages, the client adds "<Client Quit>" to mark the end of message and must transform the text message to binary format, as the server did. After that, the socket will send the message by invoking the method Send which will take the binary message as a parameter.

C#
byte[] msg = Encoding.Unicode.GetBytes(theMessageToSend + "<Client Quit>"); 
int bytesSend = senderSock.Send(msg);    

For receiving data from the server, it converts the byte array to string and continues to read the data till data isn't available:

C#
String theMessageToReceive = Encoding.Unicode.GetString(bytes, 0, bytesRec);
while (senderSock.Available > 0)
{
  bytesRec = senderSock.Receive(bytes);
  theMessageToReceive += Encoding.Unicode.GetString(bytes, 0, bytesRec);
} 

To close the connection, we should use Socket.Shutdown(SocketShutdown.Both) and Socket.Close().

After matching events with button's click, the client side user interface will look like this:

Conclusion

I provided here an application that is a sample to use and easy to integrate in your projects. So give yourself a chance to try taking benefit of socket's features to build a more rich and powerful software.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Software Developer
Tunisia Tunisia
Software Engineerwho likes spending my free time developing open source .NET applications.
Mail : houssem.dellai@live.com
Phone : +216 29 903 563

Comments and Discussions

 
QuestionSource code Pin
Member 1260492419-Mar-20 12:30
Member 1260492419-Mar-20 12:30 
QuestionCan you share that sample code Pin
Member 134079568-May-18 3:16
Member 134079568-May-18 3:16 
QuestionI see this is IPv6. How do I convert this from IPv6 to IPv4? Pin
ralpitto15-May-16 4:08
ralpitto15-May-16 4:08 
AnswerRe: I see this is IPv6. How do I convert this from IPv6 to IPv4? Pin
WJasonM12-Jul-16 3:04
WJasonM12-Jul-16 3:04 
QuestionSocket Receive Pin
zcshsh15-Mar-16 17:01
zcshsh15-Mar-16 17:01 
Questionsocket Pin
Member 122468215-Jan-16 20:21
Member 122468215-Jan-16 20:21 
Questionask for source code Pin
Member 118541854-Aug-15 19:34
Member 118541854-Aug-15 19:34 
QuestionGet a beacon Pin
jenya711-Mar-15 23:24
jenya711-Mar-15 23:24 
QuestionComment on this article Pin
Member 1024876814-Jul-14 1:06
Member 1024876814-Jul-14 1:06 
AnswerRe: Comment on this article Pin
Houssem_Dellai14-Jul-14 7:26
Houssem_Dellai14-Jul-14 7:26 
Questionsource code Pin
User 102305048-Jul-14 21:09
User 102305048-Jul-14 21:09 
QuestionClient in Windows, Server in Linux Pin
Thomhert Suprapto Siadari18-Aug-13 16:41
Thomhert Suprapto Siadari18-Aug-13 16:41 
QuestionClient stand by mode. Pin
Meryem gömeç17-Jun-13 22:18
Meryem gömeç17-Jun-13 22:18 
GeneralMy vote of 5 Pin
Cornelius Henning1-Jun-13 1:30
professionalCornelius Henning1-Jun-13 1:30 
GeneralAwesome article Pin
Barun Kumar Jha29-May-13 13:30
Barun Kumar Jha29-May-13 13:30 
QuestionMultiple messages Pin
zanatos12-Apr-13 5:41
zanatos12-Apr-13 5:41 
AnswerRe: Multiple messages Pin
Houssem_Dellai12-Apr-13 23:55
Houssem_Dellai12-Apr-13 23:55 
GeneralRe: Multiple messages Pin
zanatos14-Apr-13 6:19
zanatos14-Apr-13 6:19 
GeneralRe: Multiple messages Pin
Houssem_Dellai14-Apr-13 7:28
Houssem_Dellai14-Apr-13 7:28 
GeneralMy vote of 5 Pin
csharpbd3-Dec-12 0:53
professionalcsharpbd3-Dec-12 0:53 
GeneralMy vote of 4 Pin
Al-Samman Mahmoud2-Dec-12 1:19
Al-Samman Mahmoud2-Dec-12 1:19 
GeneralRe: My vote of 4 Pin
Houssem Dellai2-Dec-12 5:13
Houssem Dellai2-Dec-12 5:13 
GeneralA good intro Pin
pt14011-Dec-12 19:41
pt14011-Dec-12 19:41 
GeneralRe: A good intro Pin
Houssem_Dellai1-Dec-12 22:21
Houssem_Dellai1-Dec-12 22:21 
GeneralRe: A good intro Pin
pt14011-Dec-12 22:33
pt14011-Dec-12 22:33 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.