DatagramChannel Class

Definition

[Android.Runtime.Register("java/nio/channels/DatagramChannel", DoNotGenerateAcw=true)]
public abstract class DatagramChannel : Java.Nio.Channels.Spi.AbstractSelectableChannel, IDisposable, Java.Interop.IJavaPeerable, Java.Nio.Channels.IByteChannel, Java.Nio.Channels.IGatheringByteChannel, Java.Nio.Channels.IScatteringByteChannel

[<Android.Runtime.Register("java/nio/channels/DatagramChannel", DoNotGenerateAcw=true)>]
type DatagramChannel = class
    inherit AbstractSelectableChannel
    interface IByteChannel
    interface IReadableByteChannel
    interface IChannel
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IWritableByteChannel
    interface IGatheringByteChannel
    interface IScatteringByteChannel

Inheritance

Object

Object

AbstractInterruptibleChannel

SelectableChannel

AbstractSelectableChannel

DatagramChannel

Attributes

RegisterAttribute

Implements

IJavaObject IJavaPeerable ICloseable IByteChannel IChannel IGatheringByteChannel IReadableByteChannel IScatteringByteChannel IWritableByteChannel IDisposable

Remarks

A selectable channel for datagram-oriented sockets.

A datagram channel is created by invoking one of the #open open methods of this class. It is not possible to create a channel for an arbitrary, pre-existing datagram socket. A newly-created datagram channel is open but not connected. A datagram channel need not be connected in order for the #send send and #receive receive methods to be used. A datagram channel may be connected, by invoking its #connect connect method, in order to avoid the overhead of the security checks are otherwise performed as part of every send and receive operation. A datagram channel must be connected in order to use the #read(java.nio.ByteBuffer) read and #write(java.nio.ByteBuffer) write methods, since those methods do not accept or return socket addresses.

Once connected, a datagram channel remains connected until it is disconnected or closed. Whether or not a datagram channel is connected may be determined by invoking its #isConnected isConnected method.

Socket options are configured using the #setOption(SocketOption,Object) setOption method. A datagram channel to an Internet Protocol socket supports the following options: <blockquote> <table class="striped"> <caption style="display:none">Socket options</caption> <thead> <tr> <th scope="col">Option Name</th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr> <th scope="row"> java.net.StandardSocketOptions#SO_SNDBUF SO_SNDBUF</th> <td> The size of the socket send buffer </td> </tr> <tr> <th scope="row"> java.net.StandardSocketOptions#SO_RCVBUF SO_RCVBUF</th> <td> The size of the socket receive buffer </td> </tr> <tr> <th scope="row"> java.net.StandardSocketOptions#SO_REUSEADDR SO_REUSEADDR</th> <td> Re-use address </td> </tr> <tr> <th scope="row"> java.net.StandardSocketOptions#SO_BROADCAST SO_BROADCAST</th> <td> Allow transmission of broadcast datagrams </td> </tr> <tr> <th scope="row"> java.net.StandardSocketOptions#IP_TOS IP_TOS</th> <td> The Type of Service (ToS) octet in the Internet Protocol (IP) header </td> </tr> <tr> <th scope="row"> java.net.StandardSocketOptions#IP_MULTICAST_IF IP_MULTICAST_IF</th> <td> The network interface for Internet Protocol (IP) multicast datagrams </td> </tr> <tr> <th scope="row"> java.net.StandardSocketOptions#IP_MULTICAST_TTL IP_MULTICAST_TTL</th> <td> The <em>time-to-live</em> for Internet Protocol (IP) multicast datagrams </td> </tr> <tr> <th scope="row"> java.net.StandardSocketOptions#IP_MULTICAST_LOOP IP_MULTICAST_LOOP</th> <td> Loopback for Internet Protocol (IP) multicast datagrams </td> </tr> </tbody> </table> </blockquote> Additional (implementation specific) options may also be supported.

Datagram channels are safe for use by multiple concurrent threads. They support concurrent reading and writing, though at most one thread may be reading and at most one thread may be writing at any given time.

Added in 1.4.

Java documentation for java.nio.channels.DatagramChannel.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

Properties

Methods

Explicit Interface Implementations

Extension Methods

Applies to