C# in a Nutshell, Second Edition

Name

UdpClient

Synopsis

This class is used to create UDP client sockets. UDP-based clients transmit messages called datagrams across a connection. Unlike TCP, control data is not sent to ensure the integrity and order of the data (so UDP is faster than TCP, but not as reliable). UDP is often used to broadcast media streams, such as video, and to support multicasting. The UdpClient can be constructed with a binding to a local address and port, or it can be constructed given the IP address and port number of the remote server to which it connects.

The JoinMulitcastGroup( ) method sets the addres of an IP-multicast group to join. DropMulticastGroup( ) drops the client from the group.

public class UdpClient : IDisposable {
// Public Constructors
   public UdpClient( );
   public UdpClient(AddressFamily family);
   public UdpClient(int port);
   public UdpClient(int port, AddressFamily family);
   public UdpClient(System.Net.IPEndPoint localEP);
   public UdpClient(string hostname, int port);
// Protected Instance Properties
   protected bool Active{set; get; }
   protected Socket Client{set; get; }
// Public Instance Methods
   public void Close( );
   public void Connect(System.Net.IPAddress addr, int port);
   public void Connect(System.Net.IPEndPoint endPoint);
   public void Connect(string hostname, int port);
   public void DropMulticastGroup(System.Net.IPAddress multicastAddr);
}