Click here to Skip to main content
13,252,259 members (57,669 online)
Click here to Skip to main content
Add your own
alternative version


59 bookmarked
Posted 7 Jun 2005

TinyUDP - Simple UDP Client/Server Components for .NET

, 7 Jun 2005
Rate this:
Please Sign up or sign in to vote.
Simple UDP client/server components for .NET 1.1.


This article was written in the course of implementing a simple method for a Windows service to communicate status information to a front-end administration application. This article was written using the excellent article UDP send and receive using threads in VB.NET by Kumudu Gunasekara for inspiration and 'spiritual guidance', as well as some nifty ideas. Kumudu's article is definitely worth reading.


I decided to implement a simple UDP client/server system for simple communication between my Windows service and the administration program for a variety of reasons:

  1. UDP is lightweight and fast compared to other protocols, such as TCP. This was important to me, as my Windows service needed to maintain high performance.
  2. UDP is connectionless, which means that it can fire off a message and immediately free server-side network resources. Incidentally, this also makes UDP one of the easiest protocols to write a client/server application for.
  3. UDP preserves message boundaries transmitting entire messages at once.

Some of the drawbacks of UDP are:

  1. UDP does not guarantee delivery or provide for acknowledgment of receipt of messages. In this instance, that was perfectly acceptable since I was simply passing the status data from the Windows service to the UI layer.
  2. UDP has practical limits on how much data can be sent in a single message - usually limited to 1500 Bytes per message or less. Again, this limitation worked well given my scenario - I would normally not be passing more than 100 bytes per message.

Using the code

The code is pretty straightforward and well documented. There are two components: Tiny.UDP.TinyServer and Tiny.UDP.TinyClient. They are .NET 1.1 components, so they can be added to your Toolbox and dropped right in your Windows Forms; or you can reference them (as I did in the sample applications) by creating objects in the code. The code to create a server looks like this:

' Initialize a TinyServer Object
Dim server As New TinyServer

' Set it for UDP and assign the destination end point
server.Protocol = ProtocolType.Udp
server.ClientAddress = IPAddress.Parse("")
server.ClientPort = 8088

' Set the Encoding Type and Send the Message
server.Encode = EncodingType.ASCII

All we're doing here is:

  1. Creating the TinyServer object.
  2. Setting the communications protocol (currently only UDP is supported), client IP address and client port.
  3. And finally, setting the message encoding type (ASCII, UNICODE, UTF7, UTF8 and all others are supported).

Next we set up the TinyClient:

' Define a TinyClient object
Dim WithEvents client As TinyClient

' Create a client object
client = New TinyClient

' Set the inbound client port
client.ClientPort = 8088

' Set the encoding type and protocol
client.Encode = EncodingType.ASCII
client.Protocol = ProtocolType.Udp

Again, it's a simple matter to set up a client:

  1. Define and create a new TinyClient object. Notice it is declared WithEvents.
  2. Set the inbound client port number.
  3. Set the encoding type and protocol to match the TinyServer that we created.

That's a simple UDP client and server with just 10 lines of code! (Not counting comments of course.) Finally, we start the client running with the Start() method:


and send messages from the server with the SendMessage() method:

server.SendMessage ("This is a UDP Message sent by TinyServer.")

The TinyClient object was declared WithEvents because it implements two events: BeforeReceive and AfterReceive. BeforeReceive is fired immediately before receiving data off the wire. AfterReceive is fired immediately after the client finishes receiving data. You can set up your own subroutines to handle these events as you see fit. Other events may be added later; but for now I decided those two were the most important to get implemented.

How does it work?

If you look into the code, you will see that the TinyServer simply creates a System.Net.Sockets.UdpClient, opens a connection, and fires off your message when you call the SendMessage() method. Very simple. The client is where the fun begins.

On the client side, the Start() method actually fires off a worker thread that in turn starts its own System.Net.Sockets.UdpClient and waits for data. We set it off on a separate worker thread because the Receive() method blocks the current thread until it completes - and we don't need it locking up our UI. Once a message is received by the worker thread, the thread exits immediately, so we start a new worker thread to continue waiting for the next message.

Because these events are fired from the worker thread, you'll notice in the sample program that I check Me.InvokeRequired on the client form before I update it. This is necessary because of the nature of multi-threaded apps; never update the UI from a worker thread, always check InvokeRequired and use Invoke if it is True.

Finally, when we finish, fire the client.Stop() method to stop the worker thread and cleanly dispose off the UDPClient.

Points of interest

As mentioned previously, this works best on a local machine or on locally networked computers; for instance, when communicating non-critical information between layers of a locally installed application. It also has the potential for chat applications, which I'm sure has been done to death by now :) My main goal in designing this was to create a reusable, lightweight set of components that could be used to allow Windows services to easily communicate with the front-end client applications without jumping through hoops.



  • June 8th, 2005 - version 0.8.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Web Developer
United States United States
Database Admin (MCDBA) and Programmer with 15+ years' experience in data warehousing, application design and development, and systems integration.

You may also be interested in...

Comments and Discussions

GeneralMultithreading start/stop question Pin
davidm991-Dec-05 11:09
memberdavidm991-Dec-05 11:09 
QuestionInvoke Pin
Lost-Ha[n]f-PHP24-Nov-05 2:31
memberLost-Ha[n]f-PHP24-Nov-05 2:31 
AnswerRe: Invoke Pin
tupacs0128-Nov-05 4:36
membertupacs0128-Nov-05 4:36 
GeneralConfusing naming convention Pin
meraydin15-Nov-05 11:25
membermeraydin15-Nov-05 11:25 
GeneralRe: Confusing naming convention Pin
tupacs0128-Nov-05 4:40
membertupacs0128-Nov-05 4:40 
GeneralRe: Fix for naming convention and exit bug Pin
Danilo Corallo20-Feb-07 22:45
memberDanilo Corallo20-Feb-07 22:45 
GeneralProgram Continues To Run After Close Pin
Duckdoo14-Nov-05 4:57
memberDuckdoo14-Nov-05 4:57 
GeneralRe: Program Continues To Run After Close Pin
davidm9915-Nov-05 10:57
memberdavidm9915-Nov-05 10:57 
GeneralRe: Program Continues To Run After Close Pin
tupacs0128-Nov-05 4:58
membertupacs0128-Nov-05 4:58 
GeneralSetting Origin Port Pin
davidm998-Nov-05 12:04
memberdavidm998-Nov-05 12:04 
GeneralRe: Setting Origin Port Pin
davidm9915-Nov-05 11:04
memberdavidm9915-Nov-05 11:04 
GeneralRe: Setting Origin Port Pin
davidm9915-Nov-05 11:05
memberdavidm9915-Nov-05 11:05 
GeneralRe: Setting Origin Port Pin
tupacs0128-Nov-05 4:43
membertupacs0128-Nov-05 4:43 
GeneralIP address of packet sender Pin
davidm995-Nov-05 7:21
memberdavidm995-Nov-05 7:21 
GeneralRe: IP address of packet sender Pin
davidm995-Nov-05 7:26
memberdavidm995-Nov-05 7:26 
QuestionMulticast Receiver... Pin
dcarlton28-Sep-05 2:56
sussdcarlton28-Sep-05 2:56 
AnswerRe: Multicast Receiver... Pin
tupacs0128-Nov-05 4:56
membertupacs0128-Nov-05 4:56 
Generalrunning an windows application as a clent server applicaion Pin
behzad608125-Sep-05 21:47
memberbehzad608125-Sep-05 21:47 
GeneralRe: running an windows application as a clent server applicaion Pin
tupacs0126-Sep-05 13:04
membertupacs0126-Sep-05 13:04 
GeneralA minor point that I found. Pin
peter82822-Jul-05 13:24
memberpeter82822-Jul-05 13:24 
AnswerRe: A minor point that I found. Pin
studiocharlotte17-Jul-07 2:32
memberstudiocharlotte17-Jul-07 2:32 
GeneralThanks Pin
peter82822-Jul-05 13:13
memberpeter82822-Jul-05 13:13 
GeneralThoughts about your chosen transport protocol Pin
BooGhost14-Jun-05 13:31
memberBooGhost14-Jun-05 13:31 
GeneralRe: Thoughts about your chosen transport protocol Pin
tupacs0114-Jun-05 16:16
membertupacs0114-Jun-05 16:16 
GeneralPerfect! Pin
angrydba13-Jun-05 9:46
memberangrydba13-Jun-05 9:46 

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.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.171114.1 | Last Updated 8 Jun 2005
Article Copyright 2005 by tupacs01
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid